@dudousxd/nestjs-agent-react 0.13.0 → 0.15.0

package/dist/types-DFD-soWU.d.ts

@@ -0,0 +1,86 @@
+import { ComponentType, ReactNode } from 'react';
+
+/** The `ui` frame component a composed tree is pushed under (`@dudousxd/nestjs-agent-genui`'s `GENUI_TREE_COMPONENT`). */
+declare const GENUI_TREE_COMPONENT = "genui:tree";
+/** One pushed component, normalized from whatever carried it (a transcript block, a `data-ui` part, a stored entry). */
+interface GenerativeUIItem {
+    id: string;
+    component: string;
+    props: Record<string, unknown>;
+    version: number | null;
+    toolCallId: string | null;
+}
+/** A node of a composed tree (`genui:tree` frames): `{ type, props, children? }`. */
+interface GenerativeUIElement {
+    type: string;
+    props: Record<string, unknown>;
+    children?: GenerativeUIElement[];
+}
+/**
+ * An app's renderer for one component: it receives the component's props spread, plus `children`
+ * when it is a layout node in a tree. Any React component — the library never styles anything.
+ */
+type GenuiRenderer<P = any> = ComponentType<P & {
+    children?: ReactNode;
+}>;
+/** Component name → the app's renderer. */
+type GenuiRegistry = Record<string, GenuiRenderer>;
+/**
+ * Resolve a component the registry does not have — typically a tenant's own component, fetched for
+ * the exact `version` a message was rendered with. Return `null`/`undefined` for "no such
+ * component". May be async; results are cached per resolver, name and version.
+ */
+type ResolveComponent = (name: string, version: number | null) => GenuiRenderer | null | undefined | Promise<GenuiRenderer | null | undefined>;
+interface GenuiIssueLike {
+    path: (string | number)[];
+    message: string;
+}
+type ValidationLike = {
+    ok: true;
+    value: Record<string, unknown>;
+} | {
+    ok: false;
+    issues: GenuiIssueLike[];
+};
+/**
+ * What the renderer needs from a catalog to validate props before drawing them. A
+ * `@dudousxd/nestjs-agent-genui` `Catalog` satisfies it; declared structurally so this subpath does
+ * not depend on that package.
+ */
+interface GenuiCatalogLike {
+    has(name: string): boolean;
+    validate(name: string, props: unknown): Promise<ValidationLike>;
+    validateSync?(name: string, props: unknown): ValidationLike | undefined;
+}
+interface GenerativeUIOptions {
+    registry: GenuiRegistry;
+    /** Validate props against it before rendering. Components the catalog does not know render unvalidated. */
+    catalog?: GenuiCatalogLike;
+    resolveComponent?: ResolveComponent;
+}
+/** Why an item did not render. */
+type GenerativeUIProblem = {
+    reason: 'unknown';
+    item: GenerativeUIItem;
+} | {
+    reason: 'invalid';
+    item: GenerativeUIItem;
+    issues: GenuiIssueLike[];
+} | {
+    reason: 'error';
+    item: GenerativeUIItem;
+    error: unknown;
+};
+type GenerativeUIState = {
+    status: 'ready';
+    item: GenerativeUIItem;
+    Component: GenuiRenderer;
+    props: Record<string, unknown>;
+} | {
+    status: 'loading';
+    item: GenerativeUIItem;
+} | ({
+    status: 'problem';
+} & GenerativeUIProblem);
+
+export { type GenerativeUIOptions as G, type ResolveComponent as R, type GenerativeUIItem as a, type GenerativeUIProblem as b, type GenerativeUIElement as c, type GenerativeUIState as d, GENUI_TREE_COMPONENT as e, type GenuiCatalogLike as f, type GenuiIssueLike as g, type GenuiRegistry as h, type GenuiRenderer as i };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-agent-react",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/DavideCarvalho/nestjs-agent.git",
@@ -47,16 +47,37 @@
         "types": "./dist/markdown.d.cts",
         "default": "./dist/markdown.cjs"
       }
+    },
+    "./genui": {
+      "import": {
+        "types": "./dist/genui.d.ts",
+        "default": "./dist/genui.js"
+      },
+      "require": {
+        "types": "./dist/genui.d.cts",
+        "default": "./dist/genui.cjs"
+      }
+    },
+    "./genui/json-render": {
+      "import": {
+        "types": "./dist/genui-json-render.d.ts",
+        "default": "./dist/genui-json-render.js"
+      },
+      "require": {
+        "types": "./dist/genui-json-render.d.cts",
+        "default": "./dist/genui-json-render.cjs"
+      }
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@dudousxd/nestjs-agent-core": "0.22.0"
+    "@dudousxd/nestjs-agent-core": "0.23.0"
   },
   "peerDependencies": {
     "@ai-sdk/react": "^4.0.0",
+    "@json-render/react": ">=0.21.0 <1.0.0",
     "@streamdown/code": "^1.1.1",
     "@streamdown/math": "^1.0.2",
     "@streamdown/mermaid": "^1.0.2",
@@ -73,6 +94,9 @@
     "unist-util-visit": "^5.1.0"
   },
   "peerDependenciesMeta": {
+    "@json-render/react": {
+      "optional": true
+    },
     "@streamdown/code": {
       "optional": true
     },
@@ -112,6 +136,8 @@
   },
   "devDependencies": {
     "@ai-sdk/react": "4.0.17",
+    "@json-render/core": "0.21.0",
+    "@json-render/react": "0.21.0",
     "@streamdown/code": "1.1.1",
     "@streamdown/math": "1.0.2",
     "@streamdown/mermaid": "1.0.2",
@@ -133,7 +159,8 @@
     "tsup": "8.5.1",
     "typescript": "5.9.3",
     "unist-util-visit": "5.1.0",
-    "vitest": "2.1.9"
+    "vitest": "2.1.9",
+    "@dudousxd/nestjs-agent-genui": "0.2.0"
   },
   "scripts": {
     "build": "tsup",