@visulima/ono 2.0.0-alpha.8 → 2.0.0

package/CHANGELOG.md

@@ -1,3 +1,287 @@
+## @visulima/ono [2.0.0](https://github.com/visulima/visulima/compare/@visulima/ono@1.0.12...@visulima/ono@2.0.0) (2026-07-03)
+
+### ⚠ BREAKING CHANGES
+
+* change min node version to 22.13
+
+### Features
+
+* **web:** auto-generate packages page from workspace metadata ([623e520](https://github.com/visulima/visulima/commit/623e5207693a7fe720f5f2f179593a3654c880e3))
+
+### Bug Fixes
+
+* add new package image, fixed readme rendering on npm, fixed building of packages ([b790ba2](https://github.com/visulima/visulima/commit/b790ba253ea07fef83528fd822a678facf021b5f))
+* **dependencies:** update hono and isomorphic-dompurify to versions 4.11.3 and 2.35.0 in package.json files ([0169fa9](https://github.com/visulima/visulima/commit/0169fa94d187c5e6a22e2ed48353124953996aee))
+* **dependencies:** update hono and related packages to version 4.11.2 and update @hono/swagger-ui to version 0.5.3 ([5d3eed5](https://github.com/visulima/visulima/commit/5d3eed57d30d8216bf91484f35d39678938651fb))
+* **error-debugging:** resolve eslint and type-safety issues ([886dbff](https://github.com/visulima/visulima/commit/886dbffe3f744c9493fcc54e781de3fd21eebf78))
+* **ono:** 4 bug fixes ([c42baed](https://github.com/visulima/visulima/commit/c42baedb403b69d57ee25f81abf61e01ca8e71ad))
+* **ono:** annotate renderJson for isolatedDeclarations ([bf8853f](https://github.com/visulima/visulima/commit/bf8853f1ffe39485fabbe3486eac4af1dc70d5d7))
+* **ono:** collapse stringifiedBody to a single toString() call ([1847db9](https://github.com/visulima/visulima/commit/1847db944e78349f932bb6dc51e3247c5a71b01e))
+* **ono:** fix runtime detection, request masking, add json renderer ([dcbd84b](https://github.com/visulima/visulima/commit/dcbd84b80a9153e262a645e0f6ffa2b5b0dd60c6))
+* **ono:** guard circular request bodies and mask password-shaped body keys ([42a288c](https://github.com/visulima/visulima/commit/42a288cf3c0e2f3f00a02812b4879db95e718fda))
+* **ono:** properly fix eslint errors in code ([ca1d1a2](https://github.com/visulima/visulima/commit/ca1d1a2aa4d4db69f2f38d2b85d8df5e32b906fb))
+* **ono:** remove remaining eslint suppressions with proper code fixes ([ab20811](https://github.com/visulima/visulima/commit/ab20811c01df07a836303c4b4a478de79d1d338c))
+* **ono:** resolve eslint and formatting issues ([3113c1f](https://github.com/visulima/visulima/commit/3113c1fbd668a0f99016f8f590977b033d19aa96))
+* **ono:** resolve eslint errors ([4d8e045](https://github.com/visulima/visulima/commit/4d8e0455f2420bef082e3aa3f00e76461e8c17c8))
+* **ono:** update package files ([2e8a1dd](https://github.com/visulima/visulima/commit/2e8a1dd987c061f57e9e60c64a40245c499f8c98))
+* **ono:** update packem to 2.0.0-alpha.54 ([e3bf220](https://github.com/visulima/visulima/commit/e3bf220c8813bb04a1d5061c62e1897010f5340b))
+* **ono:** use min-dark/min-light shiki themes for code highlighting ([793a345](https://github.com/visulima/visulima/commit/793a345bbb9dc6520ce8d37a3488a83b1cbe8ce2))
+* **ono:** use workspace:* for internal [@visulima](https://github.com/visulima) deps ([2e4ff1a](https://github.com/visulima/visulima/commit/2e4ff1a1ae8f849f9fb4cf26e7b58446bb47c1f1))
+* remove deprecated baseUrl and downlevelIteration from tsconfigs ([a708366](https://github.com/visulima/visulima/commit/a708366b5c3bc73cfde480a712ed397bd921fb93))
+* Remove JSR configuration generation script and generated jsr.json files ([#616](https://github.com/visulima/visulima/issues/616)) ([533744b](https://github.com/visulima/visulima/commit/533744b103b74896941db5b727173e617a27a63b))
+* **storage-client:** percent-encode user fields in defaultFingerprint ([7c78a0f](https://github.com/visulima/visulima/commit/7c78a0f9512e2a673b941d80839e9f1e86b7b5d0))
+* update dependencies and improve error handling in error-debugging packages ([b95fea4](https://github.com/visulima/visulima/commit/b95fea4ef0e0a6777b3dd465603b1dd3c40aa4e8))
+* update Node.js engine version requirement to >=22.13 in multiple package.json files for improved compatibility ([b828e9a](https://github.com/visulima/visulima/commit/b828e9aeaebfc798eecddccd90e6ec7560c6d36a))
+* update package OG images across multiple packages ([f08e4dd](https://github.com/visulima/visulima/commit/f08e4dd2b105ccb29c8412020a9c2be36d6c1e9e))
+* **web:** improve build setup with incremental stats caching and prod install ([fe33e75](https://github.com/visulima/visulima/commit/fe33e75827586779b4b3a0c6d57b39f889ee6207))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0
+* **@visulima/path:** upgraded to 3.0.0
+
+## @visulima/ono [2.0.0-alpha.38](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.37...@visulima/ono@2.0.0-alpha.38) (2026-06-30)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.35
+
+## @visulima/ono [2.0.0-alpha.37](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.36...@visulima/ono@2.0.0-alpha.37) (2026-06-19)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.34
+
+## @visulima/ono [2.0.0-alpha.36](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.35...@visulima/ono@2.0.0-alpha.36) (2026-06-13)
+
+### Bug Fixes
+
+* **ono:** annotate renderJson for isolatedDeclarations ([bf8853f](https://github.com/visulima/visulima/commit/bf8853f1ffe39485fabbe3486eac4af1dc70d5d7))
+* **ono:** fix runtime detection, request masking, add json renderer ([dcbd84b](https://github.com/visulima/visulima/commit/dcbd84b80a9153e262a645e0f6ffa2b5b0dd60c6))
+* **ono:** guard circular request bodies and mask password-shaped body keys ([42a288c](https://github.com/visulima/visulima/commit/42a288cf3c0e2f3f00a02812b4879db95e718fda))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.33
+* **@visulima/path:** upgraded to 3.0.0-alpha.13
+
+## @visulima/ono [2.0.0-alpha.35](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.34...@visulima/ono@2.0.0-alpha.35) (2026-06-04)
+
+### Bug Fixes
+
+* **ono:** 4 bug fixes ([c42baed](https://github.com/visulima/visulima/commit/c42baedb403b69d57ee25f81abf61e01ca8e71ad))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.32
+* **@visulima/path:** upgraded to 3.0.0-alpha.12
+
+## @visulima/ono [2.0.0-alpha.34](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.33...@visulima/ono@2.0.0-alpha.34) (2026-06-02)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.31
+
+## @visulima/ono [2.0.0-alpha.33](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.32...@visulima/ono@2.0.0-alpha.33) (2026-05-27)
+
+### Bug Fixes
+
+* **storage-client:** percent-encode user fields in defaultFingerprint ([7c78a0f](https://github.com/visulima/visulima/commit/7c78a0f9512e2a673b941d80839e9f1e86b7b5d0))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.30
+* **@visulima/path:** upgraded to 3.0.0-alpha.11
+
+## @visulima/ono [2.0.0-alpha.32](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.31...@visulima/ono@2.0.0-alpha.32) (2026-05-26)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.29
+
+## @visulima/ono [2.0.0-alpha.31](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.30...@visulima/ono@2.0.0-alpha.31) (2026-05-26)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.28
+
+## @visulima/ono [2.0.0-alpha.30](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.29...@visulima/ono@2.0.0-alpha.30) (2026-05-20)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.27
+
+## @visulima/ono [2.0.0-alpha.29](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.28...@visulima/ono@2.0.0-alpha.29) (2026-05-19)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.26
+
+## @visulima/ono [2.0.0-alpha.28](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.27...@visulima/ono@2.0.0-alpha.28) (2026-05-16)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.25
+
+## @visulima/ono [2.0.0-alpha.27](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.26...@visulima/ono@2.0.0-alpha.27) (2026-05-14)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.24
+
+## @visulima/ono [2.0.0-alpha.26](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.25...@visulima/ono@2.0.0-alpha.26) (2026-05-11)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.23
+
+## @visulima/ono [2.0.0-alpha.25](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.24...@visulima/ono@2.0.0-alpha.25) (2026-05-11)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.22
+
+## @visulima/ono [2.0.0-alpha.24](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.23...@visulima/ono@2.0.0-alpha.24) (2026-05-10)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.21
+
+## @visulima/ono [2.0.0-alpha.23](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.22...@visulima/ono@2.0.0-alpha.23) (2026-05-10)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.20
+
+## @visulima/ono [2.0.0-alpha.22](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.21...@visulima/ono@2.0.0-alpha.22) (2026-05-07)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.19
+
+## @visulima/ono [2.0.0-alpha.21](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.20...@visulima/ono@2.0.0-alpha.21) (2026-05-07)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.18
+
+## @visulima/ono [2.0.0-alpha.20](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.19...@visulima/ono@2.0.0-alpha.20) (2026-05-06)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.17
+
+## @visulima/ono [2.0.0-alpha.19](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.18...@visulima/ono@2.0.0-alpha.19) (2026-05-06)
+
+### Bug Fixes
+
+* **ono:** collapse stringifiedBody to a single toString() call ([1847db9](https://github.com/visulima/visulima/commit/1847db944e78349f932bb6dc51e3247c5a71b01e))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.16
+
+## @visulima/ono [2.0.0-alpha.18](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.17...@visulima/ono@2.0.0-alpha.18) (2026-05-04)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.15
+
+## @visulima/ono [2.0.0-alpha.17](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.16...@visulima/ono@2.0.0-alpha.17) (2026-04-30)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.14
+
+## @visulima/ono [2.0.0-alpha.16](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.15...@visulima/ono@2.0.0-alpha.16) (2026-04-28)
+
+## @visulima/ono [2.0.0-alpha.15](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.14...@visulima/ono@2.0.0-alpha.15) (2026-04-22)
+
+### Bug Fixes
+
+* Remove JSR configuration generation script and generated jsr.json files ([#616](https://github.com/visulima/visulima/issues/616)) ([533744b](https://github.com/visulima/visulima/commit/533744b103b74896941db5b727173e617a27a63b))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.13
+* **@visulima/path:** upgraded to 3.0.0-alpha.10
+
+## @visulima/ono [2.0.0-alpha.14](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.13...@visulima/ono@2.0.0-alpha.14) (2026-04-21)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.12
+
+## @visulima/ono [2.0.0-alpha.13](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.12...@visulima/ono@2.0.0-alpha.13) (2026-04-21)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.11
+
+## @visulima/ono [2.0.0-alpha.12](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.11...@visulima/ono@2.0.0-alpha.12) (2026-04-21)
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.10
+
+## @visulima/ono [2.0.0-alpha.11](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.10...@visulima/ono@2.0.0-alpha.11) (2026-04-15)
+
+### Bug Fixes
+
+* **error-debugging:** resolve eslint and type-safety issues ([886dbff](https://github.com/visulima/visulima/commit/886dbffe3f744c9493fcc54e781de3fd21eebf78))
+* **ono:** resolve eslint and formatting issues ([3113c1f](https://github.com/visulima/visulima/commit/3113c1fbd668a0f99016f8f590977b033d19aa96))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.9
+* **@visulima/path:** upgraded to 3.0.0-alpha.9
+
+## @visulima/ono [2.0.0-alpha.10](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.9...@visulima/ono@2.0.0-alpha.10) (2026-04-09)
+
+## @visulima/ono [2.0.0-alpha.9](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.8...@visulima/ono@2.0.0-alpha.9) (2026-04-08)
+
+### Bug Fixes
+
+* **ono:** properly fix eslint errors in code ([ca1d1a2](https://github.com/visulima/visulima/commit/ca1d1a2aa4d4db69f2f38d2b85d8df5e32b906fb))
+* **ono:** remove remaining eslint suppressions with proper code fixes ([ab20811](https://github.com/visulima/visulima/commit/ab20811c01df07a836303c4b4a478de79d1d338c))
+* **ono:** resolve eslint errors ([4d8e045](https://github.com/visulima/visulima/commit/4d8e0455f2420bef082e3aa3f00e76461e8c17c8))
+* **ono:** use min-dark/min-light shiki themes for code highlighting ([793a345](https://github.com/visulima/visulima/commit/793a345bbb9dc6520ce8d37a3488a83b1cbe8ce2))
+* remove deprecated baseUrl and downlevelIteration from tsconfigs ([a708366](https://github.com/visulima/visulima/commit/a708366b5c3bc73cfde480a712ed397bd921fb93))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.8
+* **@visulima/path:** upgraded to 3.0.0-alpha.8
+
 ## @visulima/ono [2.0.0-alpha.8](https://github.com/visulima/visulima/compare/@visulima/ono@2.0.0-alpha.7...@visulima/ono@2.0.0-alpha.8) (2026-03-26)
 
 ### Features

package/README.md

@@ -263,6 +263,44 @@ Renders an error as ANSI terminal output.
 
 Returns an object with `errorAnsi` (the formatted error) and optional `solutionBox` (suggested solutions).
 
+##### `toJSON(error, options?)` => `Promise<OnoJson>`
+
+Renders an error as a structured, JSON-serializable payload — the error name/message, the parsed
+stack frames for the error and every entry in its `cause` chain, the detected runtime, and a
+suggested solution (using the same solution-finder protocol as `toHTML`/`toANSI`). Useful for
+SPA/REST error responses when the client sends `Accept: application/json`.
+
+- **error**: `unknown` - The error to render
+- **options**: `ToJsonOptions` (optional)
+    - `solutionFinders?: SolutionFinder[]` - Custom solution finders
+
+```ts
+import { renderJson } from "@visulima/ono";
+
+app.use((error, request, response, next) => {
+    if (request.accepts("json")) {
+        renderJson(error).then((payload) => response.status(500).json(payload));
+
+        return;
+    }
+
+    next(error);
+});
+```
+
+#### Standalone renderers
+
+The same three renderers are also exported as standalone, tree-shakeable functions — prefer these
+over instantiating `Ono`:
+
+```ts
+import { renderAnsi, renderHtml, renderJson } from "@visulima/ono";
+
+const html = await renderHtml(error);
+const { errorAnsi } = await renderAnsi(error);
+const json = await renderJson(error);
+```
+
 ### createRequestContextPage(request, options) => `Promise<ContentPage | undefined>`
 
 Creates a context page with detailed request debugging information.
@@ -323,10 +361,10 @@ try {
 Use `createRequestContextPage()` to create a "Context" tab with comprehensive debugging information:
 
 - **Request Overview** - cURL command with proper formatting and copy functionality
-- **Headers** - HTTP headers with smart masking for sensitive data
-- **Body** - Request body content with proper formatting
+- **Headers** - HTTP headers with smart masking for sensitive data (authorization, cookies, API keys, tokens, secrets)
+- **Body** - Request body content with sensitive-looking keys (password, token, secret, …) masked in both the rendered body and the copyable cURL
 - **Session** - Session data in organized key-value tables
-- **Cookies** - Cookie information in readable format
+- **Cookies** - Cookie values are masked by default (the `cookie` header is treated as sensitive); pass an empty `maskValue` to disable
 - **Dynamic Context Sections** - Any additional context keys you provide are automatically rendered as sections with:
     - Proper titles (capitalized)
     - Copy buttons for JSON data
@@ -495,9 +533,9 @@ Try these routes:
 
 From `@visulima/ono/server/open-in-editor`:
 
-- `openInEditor(request, options)` — core function (uses `open-editor` under the hood)
-- `createNodeHttpHandler(options)` — returns `(req, res) => void` for Node http servers
-- `createExpressHandler(options)` — returns `(req, res) => void` for Express/Connect
+- `createOpenInEditorMiddleware(options)` — universal handler factory (Node `http` and Connect/Express), backed by `launch-editor-middleware`
+- `createNodeHttpHandler(options)` — returns `(req, res) => Promise<void>` for Node `http` servers
+- `createExpressHandler(options)` — returns an Express/Connect-compatible handler
 
 Options:
 

package/dist/error-inspector/page/create-request-context.d.ts

@@ -1,4 +1,42 @@
-import type { ContentPage } from "../types.d.ts";
-import type { ContextContentOptions, RequestLike } from "./types.d.ts";
+import { C as ContentPage } from "../../packem_shared/types.d-D1UE67tt.js";
+import { IncomingMessage } from 'node:http';
+type NativeRequest = typeof globalThis.Request;
+type NativeHeaders = typeof globalThis.Headers;
+interface CustomHeaders {
+  entries: () => IterableIterator<[string, string]>;
+  forEach: (callback: (value: string, key: string) => void) => void;
+  get: (name: string) => string | null;
+}
+interface CustomRequest {
+  clone?: () => CustomRequest;
+  headers?: Record<string, string | string[]> | CustomHeaders;
+  json?: () => Promise<unknown>;
+  method?: string;
+  text?: () => Promise<string>;
+  url?: string;
+}
+type HeadersLike = NativeHeaders | CustomHeaders;
+type RequestLike = NativeRequest | (IncomingMessage & {
+  body?: unknown;
+  clone?: () => RequestLike;
+  json?: () => Promise<unknown>;
+  text?: () => Promise<string>;
+}) | CustomRequest | {
+  body?: unknown;
+  headers?: Record<string, string | string[]> | HeadersLike;
+  method?: string;
+  off?: (event: string, handler: (chunk: unknown) => void) => void;
+  on?: (event: string, handler: (chunk: unknown) => void) => void;
+  setEncoding?: (encoding: string) => void;
+  url?: string;
+};
+type ContextContentOptions = {
+  context?: Record<string, unknown>;
+  headerAllowlist?: string[];
+  headerDenylist?: string[];
+  maskValue?: string;
+  previewBytes?: number;
+  totalCapBytes?: number;
+};
 declare const createRequestContext: (request: RequestLike, options: ContextContentOptions) => Promise<ContentPage | undefined>;
-export default createRequestContext;
+export { createRequestContext as default };