ai.matey.react.nextjs 0.2.0

package/dist/esm/server.js

@@ -0,0 +1,251 @@
+/**
+ * Next.js Server Utilities
+ *
+ * Server-side utilities for Next.js App Router and API Routes.
+ *
+ * @module
+ */
+/**
+ * Create a streaming Response for Next.js App Router.
+ *
+ * @param stream - Async iterable of chunks
+ * @param options - Response options
+ * @returns Web Response with streaming body
+ *
+ * @example
+ * ```typescript
+ * // app/api/chat/route.ts
+ * import { createStreamingResponse } from 'ai.matey.react.nextjs/server';
+ * import { Bridge } from 'ai.matey.core';
+ *
+ * export async function POST(request: Request) {
+ *   const { messages } = await request.json();
+ *   const bridge = new Bridge({ backend, frontend });
+ *
+ *   const stream = bridge.chatStream({ messages });
+ *   return createStreamingResponse(stream);
+ * }
+ * ```
+ */
+export function createStreamingResponse(stream, options = {}) {
+    const { headers = {}, status = 200 } = options;
+    let body;
+    if (stream instanceof ReadableStream) {
+        body = stream;
+    }
+    else {
+        // Convert async iterable to ReadableStream
+        const encoder = new TextEncoder();
+        body = new ReadableStream({
+            async start(controller) {
+                try {
+                    for await (const chunk of stream) {
+                        controller.enqueue(encoder.encode(chunk));
+                    }
+                    controller.close();
+                }
+                catch (error) {
+                    controller.error(error);
+                }
+            },
+        });
+    }
+    return new Response(body, {
+        status,
+        headers: {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache, no-transform',
+            Connection: 'keep-alive',
+            ...headers,
+        },
+    });
+}
+/**
+ * Create a Server-Sent Events (SSE) response.
+ *
+ * @param stream - Async iterable of data objects
+ * @param options - Response options
+ * @returns Web Response with SSE body
+ *
+ * @example
+ * ```typescript
+ * // app/api/chat/route.ts
+ * import { createSSEResponse } from 'ai.matey.react.nextjs/server';
+ *
+ * export async function POST(request: Request) {
+ *   const stream = generateChatStream();
+ *   return createSSEResponse(stream);
+ * }
+ * ```
+ */
+export function createSSEResponse(stream, options = {}) {
+    const { headers = {}, status = 200 } = options;
+    const encoder = new TextEncoder();
+    const body = new ReadableStream({
+        async start(controller) {
+            try {
+                for await (const data of stream) {
+                    const sseMessage = `data: ${JSON.stringify(data)}\n\n`;
+                    controller.enqueue(encoder.encode(sseMessage));
+                }
+                // Send done signal
+                controller.enqueue(encoder.encode('data: [DONE]\n\n'));
+                controller.close();
+            }
+            catch (error) {
+                controller.error(error);
+            }
+        },
+    });
+    return new Response(body, {
+        status,
+        headers: {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache, no-transform',
+            Connection: 'keep-alive',
+            ...headers,
+        },
+    });
+}
+/**
+ * Create a chat API route handler for Next.js.
+ *
+ * @param options - Handler options
+ * @returns Route handler function
+ *
+ * @example
+ * ```typescript
+ * // app/api/chat/route.ts
+ * import { createChatHandler } from 'ai.matey.react.nextjs/server';
+ * import { Bridge } from 'ai.matey.core';
+ * import { OpenAIBackend } from 'ai.matey.backend/openai';
+ *
+ * const bridge = new Bridge({
+ *   backend: new OpenAIBackend({ apiKey: process.env.OPENAI_API_KEY }),
+ * });
+ *
+ * export const POST = createChatHandler({ bridge });
+ * ```
+ */
+export function createChatHandler(options) {
+    const { bridge: bridgeOrFactory, validate, transformRequest, transformChunk, onError } = options;
+    return async function handler(request) {
+        try {
+            // Parse request body
+            const body = (await request.json());
+            // Validate if provided
+            if (validate && !validate(body)) {
+                return new Response(JSON.stringify({ error: 'Invalid request body' }), {
+                    status: 400,
+                    headers: { 'Content-Type': 'application/json' },
+                });
+            }
+            // Get bridge instance
+            const bridge = typeof bridgeOrFactory === 'function' ? await bridgeOrFactory() : bridgeOrFactory;
+            // Transform request if provided
+            const processedBody = transformRequest ? transformRequest(body) : body;
+            // Check if streaming is requested
+            const shouldStream = processedBody.stream !== false;
+            if (shouldStream) {
+                // Streaming response
+                const stream = bridge.chatStream({
+                    messages: processedBody.messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                    model: processedBody.model,
+                    temperature: processedBody.temperature,
+                    maxTokens: processedBody.maxTokens,
+                });
+                // Transform chunks if needed
+                const transformedStream = transformChunk
+                    ? transformStreamChunks(stream, transformChunk)
+                    : stream;
+                return createSSEResponse(transformedStream);
+            }
+            else {
+                // Non-streaming response
+                const response = await bridge.chat({
+                    messages: processedBody.messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                    model: processedBody.model,
+                    temperature: processedBody.temperature,
+                    maxTokens: processedBody.maxTokens,
+                });
+                return new Response(JSON.stringify(response), {
+                    status: 200,
+                    headers: { 'Content-Type': 'application/json' },
+                });
+            }
+        }
+        catch (error) {
+            if (onError) {
+                return onError(error instanceof Error ? error : new Error(String(error)));
+            }
+            console.error('Chat handler error:', error);
+            return new Response(JSON.stringify({
+                error: error instanceof Error ? error.message : 'Internal server error',
+            }), {
+                status: 500,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+    };
+}
+/**
+ * Transform stream chunks.
+ */
+async function* transformStreamChunks(stream, transform) {
+    for await (const chunk of stream) {
+        if (typeof chunk === 'string') {
+            yield transform(chunk);
+        }
+        else if (chunk &&
+            typeof chunk === 'object' &&
+            'content' in chunk &&
+            typeof chunk.content === 'string') {
+            yield {
+                ...chunk,
+                content: transform(chunk.content),
+            };
+        }
+        else {
+            yield chunk;
+        }
+    }
+}
+/**
+ * Server action for chat completion.
+ *
+ * @example
+ * ```typescript
+ * // app/actions.ts
+ * 'use server';
+ *
+ * import { createChatAction } from 'ai.matey.react.nextjs/server';
+ * import { bridge } from './bridge';
+ *
+ * export const chatAction = createChatAction({ bridge });
+ *
+ * // In component:
+ * const result = await chatAction({ messages: [...] });
+ * ```
+ */
+export function createChatAction(options) {
+    return async function chatAction(body) {
+        const bridge = typeof options.bridge === 'function' ? await options.bridge() : options.bridge;
+        const response = await bridge.chat({
+            messages: body.messages.map((m) => ({
+                role: m.role,
+                content: m.content,
+            })),
+            model: body.model,
+            temperature: body.temperature,
+            maxTokens: body.maxTokens,
+        });
+        return response;
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/esm/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"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"}

package/dist/types/client.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Next.js Client Utilities
+ *
+ * Client-side hooks and utilities for Next.js.
+ *
+ * @module
+ */
+import type { UseChatOptions, UseChatReturn, UseCompletionOptions, UseCompletionReturn } from 'ai.matey.react.core';
+/**
+ * Extended options for Next.js useChat.
+ */
+export interface UseNextChatOptions extends UseChatOptions {
+    /** Use server action instead of API route */
+    serverAction?: (body: unknown) => Promise<unknown>;
+    /** Experimental features */
+    experimental?: {
+        /** Enable partial hydration */
+        partialHydration?: boolean;
+        /** Enable React Suspense */
+        suspense?: boolean;
+    };
+}
+/**
+ * useChat hook optimized for Next.js.
+ *
+ * Wraps the core useChat hook with Next.js-specific defaults.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ *
+ * import { useChat } from 'ai.matey.react.nextjs';
+ *
+ * export function ChatComponent() {
+ *   const { messages, input, handleInputChange, handleSubmit } = useChat();
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       {messages.map((m) => <div key={m.id}>{m.content}</div>)}
+ *       <input value={input} onChange={handleInputChange} />
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+export declare function useChat(options?: UseNextChatOptions): UseChatReturn;
+/**
+ * Extended options for Next.js useCompletion.
+ */
+export interface UseNextCompletionOptions extends UseCompletionOptions {
+    /** Use server action instead of API route */
+    serverAction?: (body: unknown) => Promise<unknown>;
+}
+/**
+ * useCompletion hook optimized for Next.js.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ *
+ * import { useCompletion } from 'ai.matey.react.nextjs';
+ *
+ * export function CompletionComponent() {
+ *   const { completion, input, handleInputChange, handleSubmit } = useCompletion();
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input value={input} onChange={handleInputChange} />
+ *       <p>{completion}</p>
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+export declare function useCompletion(options?: UseNextCompletionOptions): UseCompletionReturn;
+/**
+ * Metadata for AI-generated content.
+ */
+export interface AIMetadata {
+    /** Provider used */
+    provider?: string;
+    /** Model used */
+    model?: string;
+    /** Token usage */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** Generation time in ms */
+    generationTime?: number;
+}
+/**
+ * Options for generating metadata.
+ */
+export interface GenerateMetadataOptions {
+    /** Title template */
+    titleTemplate?: string;
+    /** Description template */
+    descriptionTemplate?: string;
+    /** Include AI attribution */
+    includeAttribution?: boolean;
+}
+/**
+ * Generate Next.js metadata from AI response.
+ *
+ * Useful for SEO when AI generates page content.
+ *
+ * @param content - AI-generated content
+ * @param aiMetadata - AI generation metadata
+ * @param options - Metadata options
+ * @returns Next.js Metadata object
+ *
+ * @example
+ * ```typescript
+ * // app/blog/[slug]/page.tsx
+ * import { generateMetadata } from 'ai.matey.react.nextjs';
+ *
+ * export async function generateMetadata({ params }) {
+ *   const article = await getAIArticle(params.slug);
+ *   return generateAIMetadata(article.content, article.aiMetadata);
+ * }
+ * ```
+ */
+export declare function generateAIMetadata(content: string, aiMetadata?: AIMetadata, options?: GenerateMetadataOptions): Record<string, unknown>;
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,6CAA6C;IAC7C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,4BAA4B;IAC5B,YAAY,CAAC,EAAE;QACb,+BAA+B;QAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,4BAA4B;QAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa,CAYvE;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,6CAA6C;IAC7C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,wBAA6B,GAAG,mBAAmB,CAWzF;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB"}

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AI Matey React Next.js
+ *
+ * Next.js integration for AI Matey.
+ *
+ * For server-side utilities, import from 'ai.matey.react.nextjs/server'.
+ *
+ * @packageDocumentation
+ */
+export { useChat, useCompletion, generateAIMetadata } from './client.js';
+export type { Message, ToolCall, ToolInvocation, Tool, ChatRequestOptions, CompletionRequestOptions, } from 'ai.matey.react.core';
+export type { UseNextChatOptions, UseNextCompletionOptions, AIMetadata, GenerateMetadataOptions, } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGzE,YAAY,EACV,OAAO,EACP,QAAQ,EACR,cAAc,EACd,IAAI,EACJ,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,UAAU,EACV,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/types/server.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Next.js Server Utilities
+ *
+ * Server-side utilities for Next.js App Router and API Routes.
+ *
+ * @module
+ */
+import type { Bridge } from 'ai.matey.core';
+/**
+ * Streaming response options.
+ */
+export interface StreamingResponseOptions {
+    /** Response headers */
+    headers?: Record<string, string>;
+    /** Response status code */
+    status?: number;
+}
+/**
+ * Create a streaming Response for Next.js App Router.
+ *
+ * @param stream - Async iterable of chunks
+ * @param options - Response options
+ * @returns Web Response with streaming body
+ *
+ * @example
+ * ```typescript
+ * // app/api/chat/route.ts
+ * import { createStreamingResponse } from 'ai.matey.react.nextjs/server';
+ * import { Bridge } from 'ai.matey.core';
+ *
+ * export async function POST(request: Request) {
+ *   const { messages } = await request.json();
+ *   const bridge = new Bridge({ backend, frontend });
+ *
+ *   const stream = bridge.chatStream({ messages });
+ *   return createStreamingResponse(stream);
+ * }
+ * ```
+ */
+export declare function createStreamingResponse(stream: AsyncIterable<string> | ReadableStream<Uint8Array>, options?: StreamingResponseOptions): Response;
+/**
+ * Create a Server-Sent Events (SSE) response.
+ *
+ * @param stream - Async iterable of data objects
+ * @param options - Response options
+ * @returns Web Response with SSE body
+ *
+ * @example
+ * ```typescript
+ * // app/api/chat/route.ts
+ * import { createSSEResponse } from 'ai.matey.react.nextjs/server';
+ *
+ * export async function POST(request: Request) {
+ *   const stream = generateChatStream();
+ *   return createSSEResponse(stream);
+ * }
+ * ```
+ */
+export declare function createSSEResponse<T>(stream: AsyncIterable<T>, options?: StreamingResponseOptions): Response;
+/**
+ * Options for creating a chat handler.
+ */
+export interface CreateChatHandlerOptions {
+    /** Bridge instance or factory */
+    bridge: Bridge | (() => Bridge | Promise<Bridge>);
+    /** Request validation */
+    validate?: (body: unknown) => boolean;
+    /** Transform request before processing */
+    transformRequest?: (body: ChatRequestBody) => ChatRequestBody;
+    /** Transform response chunks */
+    transformChunk?: (chunk: string) => string;
+    /** Error handler */
+    onError?: (error: Error) => Response;
+}
+/**
+ * Chat request body structure.
+ */
+export interface ChatRequestBody {
+    /** Chat messages */
+    messages: Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+    /** Model to use */
+    model?: string;
+    /** Temperature */
+    temperature?: number;
+    /** Max tokens */
+    maxTokens?: number;
+    /** Stream response */
+    stream?: boolean;
+    /** Additional options */
+    [key: string]: unknown;
+}
+/**
+ * Create a chat API route handler for Next.js.
+ *
+ * @param options - Handler options
+ * @returns Route handler function
+ *
+ * @example
+ * ```typescript
+ * // app/api/chat/route.ts
+ * import { createChatHandler } from 'ai.matey.react.nextjs/server';
+ * import { Bridge } from 'ai.matey.core';
+ * import { OpenAIBackend } from 'ai.matey.backend/openai';
+ *
+ * const bridge = new Bridge({
+ *   backend: new OpenAIBackend({ apiKey: process.env.OPENAI_API_KEY }),
+ * });
+ *
+ * export const POST = createChatHandler({ bridge });
+ * ```
+ */
+export declare function createChatHandler(options: CreateChatHandlerOptions): (request: Request) => Promise<Response>;
+/**
+ * Server action for chat completion.
+ *
+ * @example
+ * ```typescript
+ * // app/actions.ts
+ * 'use server';
+ *
+ * import { createChatAction } from 'ai.matey.react.nextjs/server';
+ * import { bridge } from './bridge';
+ *
+ * export const chatAction = createChatAction({ bridge });
+ *
+ * // In component:
+ * const result = await chatAction({ messages: [...] });
+ * ```
+ */
+export declare function createChatAction(options: {
+    bridge: Bridge | (() => Bridge | Promise<Bridge>);
+}): (body: ChatRequestBody) => Promise<unknown>;
+//# sourceMappingURL=server.d.ts.map

package/dist/types/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,EAC1D,OAAO,GAAE,wBAA6B,GACrC,QAAQ,CAiCV;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,OAAO,GAAE,wBAA6B,GACrC,QAAQ,CA8BV;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,yBAAyB;IACzB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACtC,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,eAAe,CAAC;IAC9D,gCAAgC;IAChC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yBAAyB;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,IAGnC,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CA2EnE;AA4BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,IAC5D,MAAM,eAAe,sBAevD"}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "ai.matey.react.nextjs",
+  "version": "0.2.0",
+  "description": "Next.js integration for AI Matey - App Router, Server Actions, API Routes",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/types/server.d.ts",
+        "default": "./dist/esm/server.js"
+      },
+      "require": {
+        "types": "./dist/types/server.d.ts",
+        "default": "./dist/cjs/server.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "readme.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "ai.matey.types": "*",
+    "ai.matey.core": "*",
+    "ai.matey.react.core": "*"
+  },
+  "peerDependencies": {
+    "next": ">=13.0.0",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": false
+    },
+    "react": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "next": "^14.0.0",
+    "react": "^18.2.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "react",
+    "nextjs",
+    "app-router",
+    "server-actions",
+    "ai-matey"
+  ],
+  "author": "AI Matey",
+  "license": "MIT",
+  "homepage": "https://github.com/johnhenry/ai.matey#readme",
+  "bugs": {
+    "url": "https://github.com/johnhenry/ai.matey/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johnhenry/ai.matey.git",
+    "directory": "packages/react-nextjs"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}