elysia-vision 0.1.0

package/dist/cjs/constants.d.ts

@@ -0,0 +1,6 @@
+declare const VISION_CALL_EVENT_NAME = "vision-call";
+declare const VISION_REQUEST_ID_HEADER = "vision-request-id";
+declare const VISION_PATHS: string[];
+declare const HEADERS_TO_REMOVE: string[];
+
+export { HEADERS_TO_REMOVE, VISION_CALL_EVENT_NAME, VISION_PATHS, VISION_REQUEST_ID_HEADER };

package/dist/cjs/constants.js

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/constants.ts
+var constants_exports = {};
+__export(constants_exports, {
+  HEADERS_TO_REMOVE: () => HEADERS_TO_REMOVE,
+  VISION_CALL_EVENT_NAME: () => VISION_CALL_EVENT_NAME,
+  VISION_PATHS: () => VISION_PATHS,
+  VISION_REQUEST_ID_HEADER: () => VISION_REQUEST_ID_HEADER
+});
+module.exports = __toCommonJS(constants_exports);
+var VISION_CALL_EVENT_NAME = "vision-call";
+var VISION_REQUEST_ID_HEADER = "vision-request-id";
+var VISION_PATHS = ["/vision", "/.well-known"];
+var HEADERS_TO_REMOVE = [VISION_REQUEST_ID_HEADER];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HEADERS_TO_REMOVE,
+  VISION_CALL_EVENT_NAME,
+  VISION_PATHS,
+  VISION_REQUEST_ID_HEADER
+});

package/dist/cjs/index.d.ts

@@ -0,0 +1,42 @@
+import { Elysia } from 'elysia';
+
+declare const vision: () => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    vision: {
+        subscribe: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {};
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}> | null;
+
+export { vision as default };

package/dist/cjs/index.js

@@ -0,0 +1,111 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_elysia = require("elysia");
+
+// src/constants.ts
+var VISION_CALL_EVENT_NAME = "vision-call";
+var VISION_REQUEST_ID_HEADER = "vision-request-id";
+var VISION_PATHS = ["/vision", "/.well-known"];
+var HEADERS_TO_REMOVE = [VISION_REQUEST_ID_HEADER];
+
+// src/utils.ts
+var sanitizeHeaders = (headers) => {
+  return Object.fromEntries(
+    Object.entries(headers).filter(([key]) => !HEADERS_TO_REMOVE.includes(key)).map(([key, value]) => [
+      key,
+      Array.isArray(value) ? value.join(", ") : value
+    ])
+  );
+};
+
+// src/index.ts
+var vision = () => {
+  if (process.env.NODE_ENV === "production") {
+    return null;
+  }
+  const clients = /* @__PURE__ */ new Set();
+  const calls = /* @__PURE__ */ new Map();
+  const emit = (eventName, data) => {
+    const payload = {
+      event: eventName,
+      payload: data
+    };
+    for (const ws of clients) {
+      try {
+        ws.send(payload);
+      } catch {
+      }
+    }
+  };
+  const app = new import_elysia.Elysia({
+    name: "elysia-vision"
+  }).onRequest(async ({ request, set }) => {
+    const clonedRequest = request.clone();
+    const url = new URL(clonedRequest.url);
+    if (VISION_PATHS.some((path) => url.pathname.startsWith(path))) {
+      return;
+    }
+    const visionRequestId = Bun.randomUUIDv7();
+    set.headers[VISION_REQUEST_ID_HEADER] = visionRequestId;
+    const visionRequest = {
+      method: clonedRequest.method,
+      path: url.pathname + url.search,
+      timestamp: Date.now(),
+      body: clonedRequest.body ? JSON.stringify(await clonedRequest.body.json()) : null,
+      headers: sanitizeHeaders(set.headers)
+    };
+    const visionCall = {
+      request: visionRequest,
+      response: null,
+      id: visionRequestId
+    };
+    calls.set(visionRequestId, visionCall);
+    emit(VISION_CALL_EVENT_NAME, visionCall);
+  }).onAfterResponse(({ responseValue, set }) => {
+    const visionRequestId = set.headers[VISION_REQUEST_ID_HEADER];
+    if (!visionRequestId || visionRequestId === "") return;
+    const visionResponse = {
+      body: responseValue ? JSON.stringify(responseValue) : null,
+      status: set.status,
+      timestamp: Date.now(),
+      headers: sanitizeHeaders(set.headers)
+    };
+    const call = calls.get(visionRequestId);
+    if (!call) return;
+    call.response = visionResponse;
+    calls.set(visionRequestId, call);
+    emit(VISION_CALL_EVENT_NAME, call);
+  }).ws("/vision", {
+    open: (ws) => {
+      clients.add(ws);
+    },
+    close: (ws) => {
+      clients.delete(ws);
+    }
+  }).as("global");
+  return app;
+};
+var index_default = vision;

package/dist/cjs/types.d.ts

@@ -0,0 +1,24 @@
+type _INTERNAL_VisionWebSocketPayload<T> = {
+    event: string;
+    payload: T;
+};
+type VisionRequest = {
+    method: string;
+    path: string;
+    timestamp: number;
+    body: string | null;
+    headers: Record<string, string | number>;
+};
+type VisionResponse = {
+    timestamp: number;
+    body: string | null;
+    status: number;
+    headers: Record<string, string | number>;
+};
+type VisionCall = {
+    id: string;
+    request: VisionRequest;
+    response: VisionResponse | null;
+};
+
+export type { VisionCall, VisionRequest, VisionResponse, _INTERNAL_VisionWebSocketPayload };

package/dist/cjs/types.js

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/cjs/utils.d.ts

@@ -0,0 +1,5 @@
+import { HTTPHeaders } from 'elysia';
+
+declare const sanitizeHeaders: (headers: HTTPHeaders) => Record<string, string | number>;
+
+export { sanitizeHeaders };

package/dist/cjs/utils.js

@@ -0,0 +1,43 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  sanitizeHeaders: () => sanitizeHeaders
+});
+module.exports = __toCommonJS(utils_exports);
+
+// src/constants.ts
+var VISION_REQUEST_ID_HEADER = "vision-request-id";
+var HEADERS_TO_REMOVE = [VISION_REQUEST_ID_HEADER];
+
+// src/utils.ts
+var sanitizeHeaders = (headers) => {
+  return Object.fromEntries(
+    Object.entries(headers).filter(([key]) => !HEADERS_TO_REMOVE.includes(key)).map(([key, value]) => [
+      key,
+      Array.isArray(value) ? value.join(", ") : value
+    ])
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sanitizeHeaders
+});

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+declare const VISION_CALL_EVENT_NAME = "vision-call";
+declare const VISION_REQUEST_ID_HEADER = "vision-request-id";
+declare const VISION_PATHS: string[];
+declare const HEADERS_TO_REMOVE: string[];
+
+export { HEADERS_TO_REMOVE, VISION_CALL_EVENT_NAME, VISION_PATHS, VISION_REQUEST_ID_HEADER };

package/dist/constants.mjs

@@ -0,0 +1,11 @@
+// src/constants.ts
+var VISION_CALL_EVENT_NAME = "vision-call";
+var VISION_REQUEST_ID_HEADER = "vision-request-id";
+var VISION_PATHS = ["/vision", "/.well-known"];
+var HEADERS_TO_REMOVE = [VISION_REQUEST_ID_HEADER];
+export {
+  HEADERS_TO_REMOVE,
+  VISION_CALL_EVENT_NAME,
+  VISION_PATHS,
+  VISION_REQUEST_ID_HEADER
+};

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import { Elysia } from 'elysia';
+
+declare const vision: () => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    vision: {
+        subscribe: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {};
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}> | null;
+
+export { vision as default };

package/dist/index.mjs

@@ -0,0 +1,90 @@
+// src/index.ts
+import { Elysia } from "elysia";
+
+// src/constants.ts
+var VISION_CALL_EVENT_NAME = "vision-call";
+var VISION_REQUEST_ID_HEADER = "vision-request-id";
+var VISION_PATHS = ["/vision", "/.well-known"];
+var HEADERS_TO_REMOVE = [VISION_REQUEST_ID_HEADER];
+
+// src/utils.ts
+var sanitizeHeaders = (headers) => {
+  return Object.fromEntries(
+    Object.entries(headers).filter(([key]) => !HEADERS_TO_REMOVE.includes(key)).map(([key, value]) => [
+      key,
+      Array.isArray(value) ? value.join(", ") : value
+    ])
+  );
+};
+
+// src/index.ts
+var vision = () => {
+  if (process.env.NODE_ENV === "production") {
+    return null;
+  }
+  const clients = /* @__PURE__ */ new Set();
+  const calls = /* @__PURE__ */ new Map();
+  const emit = (eventName, data) => {
+    const payload = {
+      event: eventName,
+      payload: data
+    };
+    for (const ws of clients) {
+      try {
+        ws.send(payload);
+      } catch {
+      }
+    }
+  };
+  const app = new Elysia({
+    name: "elysia-vision"
+  }).onRequest(async ({ request, set }) => {
+    const clonedRequest = request.clone();
+    const url = new URL(clonedRequest.url);
+    if (VISION_PATHS.some((path) => url.pathname.startsWith(path))) {
+      return;
+    }
+    const visionRequestId = Bun.randomUUIDv7();
+    set.headers[VISION_REQUEST_ID_HEADER] = visionRequestId;
+    const visionRequest = {
+      method: clonedRequest.method,
+      path: url.pathname + url.search,
+      timestamp: Date.now(),
+      body: clonedRequest.body ? JSON.stringify(await clonedRequest.body.json()) : null,
+      headers: sanitizeHeaders(set.headers)
+    };
+    const visionCall = {
+      request: visionRequest,
+      response: null,
+      id: visionRequestId
+    };
+    calls.set(visionRequestId, visionCall);
+    emit(VISION_CALL_EVENT_NAME, visionCall);
+  }).onAfterResponse(({ responseValue, set }) => {
+    const visionRequestId = set.headers[VISION_REQUEST_ID_HEADER];
+    if (!visionRequestId || visionRequestId === "") return;
+    const visionResponse = {
+      body: responseValue ? JSON.stringify(responseValue) : null,
+      status: set.status,
+      timestamp: Date.now(),
+      headers: sanitizeHeaders(set.headers)
+    };
+    const call = calls.get(visionRequestId);
+    if (!call) return;
+    call.response = visionResponse;
+    calls.set(visionRequestId, call);
+    emit(VISION_CALL_EVENT_NAME, call);
+  }).ws("/vision", {
+    open: (ws) => {
+      clients.add(ws);
+    },
+    close: (ws) => {
+      clients.delete(ws);
+    }
+  }).as("global");
+  return app;
+};
+var index_default = vision;
+export {
+  index_default as default
+};

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+type _INTERNAL_VisionWebSocketPayload<T> = {
+    event: string;
+    payload: T;
+};
+type VisionRequest = {
+    method: string;
+    path: string;
+    timestamp: number;
+    body: string | null;
+    headers: Record<string, string | number>;
+};
+type VisionResponse = {
+    timestamp: number;
+    body: string | null;
+    status: number;
+    headers: Record<string, string | number>;
+};
+type VisionCall = {
+    id: string;
+    request: VisionRequest;
+    response: VisionResponse | null;
+};
+
+export type { VisionCall, VisionRequest, VisionResponse, _INTERNAL_VisionWebSocketPayload };

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+import { HTTPHeaders } from 'elysia';
+
+declare const sanitizeHeaders: (headers: HTTPHeaders) => Record<string, string | number>;
+
+export { sanitizeHeaders };

package/dist/utils.mjs

@@ -0,0 +1,16 @@
+// src/constants.ts
+var VISION_REQUEST_ID_HEADER = "vision-request-id";
+var HEADERS_TO_REMOVE = [VISION_REQUEST_ID_HEADER];
+
+// src/utils.ts
+var sanitizeHeaders = (headers) => {
+  return Object.fromEntries(
+    Object.entries(headers).filter(([key]) => !HEADERS_TO_REMOVE.includes(key)).map(([key, value]) => [
+      key,
+      Array.isArray(value) ? value.join(", ") : value
+    ])
+  );
+};
+export {
+  sanitizeHeaders
+};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "elysia-vision",
+  "version": "0.1.0",
+  "description": "Plugin for Elysia that monitors your API requests in real-time through a web dashboard.",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "author": {
+    "name": "rouret",
+    "url": "https://github.com/rouret"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rouret/elysia-vision"
+  },
+  "homepage": "https://github.com/rouret/elysia-vision",
+  "keywords": [
+    "elysia",
+    "vision"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "test": "bun test",
+    "dev": "bun --hot test/local.ts",
+    "release": "bun --hot test/release.ts",
+    "fakeClient": "bun test/fakeClient.ts",
+    "build": "bun build.ts"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.5",
+    "elysia": "^1.4.19",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "elysia": ">= 1.4.0"
+  }
+}