npm - @tyndall/dev - Versions diffs - 0.0.1 - Mend

@tyndall/dev 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/dist/inspector.d.ts ADDED Viewed

@@ -0,0 +1,29 @@
+export declare const INSPECTOR_PATH = "/__hyper/inspector";
+export declare const INSPECTOR_API_PATH = "/__hyper/inspector.json";
+export type DevRequestKind = "route" | "asset" | "api" | "hmr" | "inspector" | "notfound" | "unknown";
+export interface DevTimingEntry {
+    id: string;
+    method: string;
+    path: string;
+    status: number;
+    durationMs: number;
+    timestamp: number;
+    routeId?: string;
+    kind: DevRequestKind;
+}
+export interface DevInspectorSnapshot {
+    startedAt: number;
+    now: number;
+    totalRequests: number;
+    entries: DevTimingEntry[];
+}
+export interface DevInspector {
+    recordRequest: (entry: Omit<DevTimingEntry, "id" | "timestamp">) => void;
+    getSnapshot: () => DevInspectorSnapshot;
+}
+export interface DevInspectorOptions {
+    maxEntries?: number;
+}
+export declare const createDevInspector: (options?: DevInspectorOptions) => DevInspector;
+export declare const renderInspectorHtml: (snapshot: DevInspectorSnapshot) => string;
+//# sourceMappingURL=inspector.d.ts.map

package/dist/inspector.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../src/inspector.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAE5D,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,OAAO,GACP,KAAK,GACL,KAAK,GACL,WAAW,GACX,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,CAAC;IACzE,WAAW,EAAE,MAAM,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,kBAAkB,GAAI,UAAS,mBAAwB,KAAG,YA6BtE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,UAAU,oBAAoB,WAgDjE,CAAC"}

package/dist/inspector.js ADDED Viewed

@@ -0,0 +1,76 @@
+export const INSPECTOR_PATH = "/__hyper/inspector";
+export const INSPECTOR_API_PATH = "/__hyper/inspector.json";
+export const createDevInspector = (options = {}) => {
+    const maxEntries = options.maxEntries ?? 100;
+    const startedAt = Date.now();
+    let totalRequests = 0;
+    const entries = [];
+    const recordRequest = (entry) => {
+        totalRequests += 1;
+        const next = {
+            ...entry,
+            id: `${totalRequests}`,
+            timestamp: Date.now(),
+        };
+        entries.unshift(next);
+        // Keep only the most recent entries to avoid unbounded memory growth.
+        if (entries.length > maxEntries) {
+            entries.length = maxEntries;
+        }
+    };
+    return {
+        recordRequest,
+        getSnapshot: () => ({
+            startedAt,
+            now: Date.now(),
+            totalRequests,
+            entries: [...entries],
+        }),
+    };
+};
+export const renderInspectorHtml = (snapshot) => {
+    const rows = snapshot.entries
+        .map((entry) => `
+        <tr>
+          <td>${entry.method}</td>
+          <td>${entry.path}</td>
+          <td>${entry.status}</td>
+          <td>${entry.kind}</td>
+          <td>${entry.routeId ?? "-"}</td>
+          <td>${entry.durationMs.toFixed(1)}ms</td>
+        </tr>
+      `)
+        .join("");
+    return `<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>Hyper Dev Inspector</title>
+  <style>
+    body { font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; padding: 24px; }
+    table { width: 100%; border-collapse: collapse; }
+    th, td { border-bottom: 1px solid #e2e2e2; padding: 6px 8px; text-align: left; font-size: 12px; }
+    th { background: #f7f7f7; }
+  </style>
+</head>
+<body>
+  <h1>Hyper Dev Inspector</h1>
+  <p>Requests: ${snapshot.totalRequests}</p>
+  <table>
+    <thead>
+      <tr>
+        <th>Method</th>
+        <th>Path</th>
+        <th>Status</th>
+        <th>Kind</th>
+        <th>Route</th>
+        <th>Duration</th>
+      </tr>
+    </thead>
+    <tbody>
+      ${rows || "<tr><td colspan=\\\"6\\\">No requests yet.</td></tr>"}
+    </tbody>
+  </table>
+</body>
+</html>`;
+};

package/dist/watcher.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import { watch as fsWatch } from "node:fs";
+export interface WatcherOptions {
+    paths: string[];
+    debounceMs?: number;
+    onInvalidate: (changedPaths: string[]) => void;
+    watch?: typeof fsWatch;
+}
+export interface FileWatcher {
+    notifyChange: (filePath: string) => void;
+    close: () => void;
+}
+export declare const createFileWatcher: (options: WatcherOptions) => FileWatcher;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC;AAG3C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAaD,eAAO,MAAM,iBAAiB,GAAI,SAAS,cAAc,KAAG,WAuD3D,CAAC"}

package/dist/watcher.js ADDED Viewed

@@ -0,0 +1,64 @@
+import { watch as fsWatch } from "node:fs";
+import { join } from "node:path";
+const normalizePath = (base, filePath) => {
+    if (typeof filePath === "string") {
+        return filePath.length > 0 ? join(base, filePath) : base;
+    }
+    if (filePath) {
+        const asString = filePath.toString();
+        return asString.length > 0 ? join(base, asString) : base;
+    }
+    return base;
+};
+export const createFileWatcher = (options) => {
+    const watchImpl = options.watch ?? fsWatch;
+    const debounceMs = options.debounceMs ?? 25;
+    const pending = new Set();
+    let timer = null;
+    const flush = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        if (pending.size === 0) {
+            return;
+        }
+        // Important: sort to keep invalidation order deterministic in logs/tests.
+        const batch = Array.from(pending).sort();
+        pending.clear();
+        options.onInvalidate(batch);
+    };
+    const scheduleFlush = () => {
+        if (timer) {
+            return;
+        }
+        timer = setTimeout(flush, debounceMs);
+    };
+    const notifyChange = (filePath) => {
+        pending.add(filePath);
+        scheduleFlush();
+    };
+    const watchers = options.paths.map((path) => {
+        try {
+            const watcher = watchImpl(path, { recursive: true }, (_event, filename) => {
+                notifyChange(normalizePath(path, filename));
+            });
+            return watcher;
+        }
+        catch {
+            return null;
+        }
+    });
+    return {
+        notifyChange,
+        close: () => {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            for (const watcher of watchers) {
+                watcher?.close();
+            }
+        },
+    };
+};

package/package.json ADDED Viewed

@@ -0,0 +1,29 @@
+{
+  "name": "@tyndall/dev",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@tyndall/core": "workspace:*",
+    "@tyndall/dynamic-graph": "workspace:*",
+    "@tyndall/shared": "workspace:*",
+    "ws": "^8.18.0"
+  }
+}