@hazeljs/inspector 0.7.9 → 0.8.1

package/README.md

@@ -50,14 +50,14 @@ Then run your app and open:
 
 ## Configuration
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `enableInspector` | `true` | Enable the inspector |
-| `inspectorBasePath` | `'/__hazel'` | Base path for all inspector endpoints |
-| `exposeUi` | `true` | Serve the DevTools UI at the base path |
-| `exposeJson` | `true` | Expose JSON endpoints |
-| `developmentOnly` | `true` | Disable in production (NODE_ENV=production) |
-| `maxSnapshotCacheAgeMs` | `5000` | Cache snapshot for 5 seconds |
+| Option                  | Default      | Description                                 |
+| ----------------------- | ------------ | ------------------------------------------- |
+| `enableInspector`       | `true`       | Enable the inspector                        |
+| `inspectorBasePath`     | `'/__hazel'` | Base path for all inspector endpoints       |
+| `exposeUi`              | `true`       | Serve the DevTools UI at the base path      |
+| `exposeJson`            | `true`       | Expose JSON endpoints                       |
+| `developmentOnly`       | `true`       | Disable in production (NODE_ENV=production) |
+| `maxSnapshotCacheAgeMs` | `5000`       | Cache snapshot for 5 seconds                |
 
 ## Security
 
@@ -75,9 +75,7 @@ import { HazelInspectorRegistry, type HazelInspectorPlugin } from '@hazeljs/insp
 const myPlugin: HazelInspectorPlugin = {
   name: 'my-plugin',
   supports: (ctx) => true,
-  inspect: async (ctx) => [
-    { id: 'custom:1', kind: 'route', packageName: '@my/package', /* ... */ },
-  ],
+  inspect: async (ctx) => [{ id: 'custom:1', kind: 'route', packageName: '@my/package' /* ... */ }],
 };
 
 // Register during bootstrap (e.g. in a provider that runs early)

package/dist/inspector.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspector.module.d.ts","sourceRoot":"","sources":["../src/inspector.module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AA6BlF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe;sBACR,sBAAsB,GAAG,aAAa;CA6CzD,CAAC"}
+{"version":3,"file":"inspector.module.d.ts","sourceRoot":"","sources":["../src/inspector.module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AA8BlF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe;sBACR,sBAAsB,GAAG,aAAa;CA8CzD,CAAC"}

package/dist/inspector.module.js

@@ -41,6 +41,7 @@ const data_inspector_1 = require("./plugins/data.inspector");
 const serverless_inspector_1 = require("./plugins/serverless.inspector");
 const ml_inspector_1 = require("./plugins/ml.inspector");
 const worker_inspector_1 = require("./plugins/worker.inspector");
+const hcel_inspector_1 = require("./plugins/hcel.inspector");
 const inspector_config_1 = require("./config/inspector.config");
 const inspector_runtime_1 = require("./runtime/inspector-runtime");
 /** Eagerly resolves InspectorBootstrap so the early handler gets registered */
@@ -97,6 +98,7 @@ exports.InspectorModule = {
                 registry.register(serverless_inspector_1.serverlessInspector);
                 registry.register(ml_inspector_1.mlInspector);
                 registry.register(worker_inspector_1.workerInspector);
+                registry.register(hcel_inspector_1.hcelInspector);
                 const basePath = config.inspectorBasePath ?? '/__hazel';
                 const handler = createInspectorHandler(service, config, app);
                 app.addEarlyHandler(basePath, handler);
@@ -456,6 +458,20 @@ function createInspectorHandler(service, config, app) {
                 res.end(JSON.stringify({ entries: workers }));
                 return;
             }
+            if (pathSeg === '/hcel/trace' || pathSeg === '/hcel/trace/') {
+                try {
+                    const ai = require('@hazeljs/ai');
+                    ai.setHCELGlobalTraceEnabled?.(true);
+                    const events = ai.getHCELTraceSnapshot?.() ?? [];
+                    res.writeHead(200);
+                    res.end(JSON.stringify({ events }));
+                }
+                catch (err) {
+                    res.writeHead(500);
+                    res.end(JSON.stringify({ error: String(err) }));
+                }
+                return;
+            }
             if (pathSeg === '/' || pathSeg === '') {
                 res.writeHead(200);
                 res.end(JSON.stringify({
@@ -482,6 +498,7 @@ function createInspectorHandler(service, config, app) {
                         '/serverless',
                         '/ml',
                         '/workers',
+                        '/hcel/trace',
                         '/stats',
                     ],
                 }));

package/dist/plugins/hcel.inspector.d.ts

@@ -0,0 +1,6 @@
+/**
+ * HCEL trace inspector — requires @hazeljs/ai
+ */
+import type { HazelInspectorPlugin } from '../contracts/types';
+export declare const hcelInspector: HazelInspectorPlugin;
+//# sourceMappingURL=hcel.inspector.d.ts.map

package/dist/plugins/hcel.inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcel.inspector.d.ts","sourceRoot":"","sources":["../../src/plugins/hcel.inspector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,oBAAoB,CAAC;AAW/E,eAAO,MAAM,aAAa,EAAE,oBA4B3B,CAAC"}

package/dist/plugins/hcel.inspector.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * HCEL trace inspector — requires @hazeljs/ai
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hcelInspector = void 0;
+function tryGetAI() {
+    try {
+        require.resolve('@hazeljs/ai');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+exports.hcelInspector = {
+    name: 'hcel',
+    version: '1.0.0',
+    supports: () => tryGetAI(),
+    inspect: async () => {
+        if (!tryGetAI())
+            return [];
+        try {
+            const ai = require('@hazeljs/ai');
+            ai.setHCELGlobalTraceEnabled?.(true);
+            const trace = ai.getHCELTraceSnapshot?.() ?? [];
+            return [
+                {
+                    id: 'hcel:trace',
+                    kind: 'decorator',
+                    packageName: '@hazeljs/ai',
+                    decoratorName: 'HCELTrace',
+                    targetType: 'class',
+                    targetClass: 'HCELEngine',
+                    decoratorArguments: [{ bufferedEvents: trace.length }],
+                },
+            ];
+        }
+        catch {
+            return [];
+        }
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hazeljs/inspector",
-  "version": "0.7.9",
+  "version": "0.8.1",
   "description": "Framework-aware runtime inspector for HazelJS - metadata explorer and DevTools UI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -87,7 +87,7 @@
     }
   },
   "devDependencies": {
-    "@hazeljs/core": "^0.7.9",
+    "@hazeljs/core": "^0.8.1",
     "@types/jest": "^29.5.14",
     "@types/node": "^20.19.39",
     "@typescript-eslint/eslint-plugin": "^8.58.0",
@@ -120,5 +120,5 @@
     "url": "https://github.com/hazeljs/hazel-js/issues"
   },
   "homepage": "https://hazeljs.ai",
-  "gitHead": "28c21c509aeca3bf2d0878fbee737d906b654c67"
+  "gitHead": "8b7685d1250c4622f25d83992f58e13a59bb3dba"
 }