ai.matey.react.nextjs 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AI Matey Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cjs/client.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Next.js Client Utilities
+ *
+ * Client-side hooks and utilities for Next.js.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChat = useChat;
+exports.useCompletion = useCompletion;
+exports.generateAIMetadata = generateAIMetadata;
+const ai_matey_react_core_1 = require("ai.matey.react.core");
+/**
+ * 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>
+ *   );
+ * }
+ * ```
+ */
+function useChat(options = {}) {
+    const { serverAction, experimental, ...coreOptions } = options;
+    // Default API to Next.js convention
+    const api = coreOptions.api ?? '/api/chat';
+    return (0, ai_matey_react_core_1.useChat)({
+        ...coreOptions,
+        api,
+        // Use SSE stream protocol by default for Next.js
+        streamProtocol: coreOptions.streamProtocol ?? 'data',
+    });
+}
+/**
+ * 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>
+ *   );
+ * }
+ * ```
+ */
+function useCompletion(options = {}) {
+    const { serverAction, ...coreOptions } = options;
+    // Default API to Next.js convention
+    const api = coreOptions.api ?? '/api/completion';
+    return (0, ai_matey_react_core_1.useCompletion)({
+        ...coreOptions,
+        api,
+        streamProtocol: coreOptions.streamProtocol ?? 'data',
+    });
+}
+/**
+ * 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);
+ * }
+ * ```
+ */
+function generateAIMetadata(content, aiMetadata, options = {}) {
+    const { titleTemplate, descriptionTemplate, includeAttribution = false } = options;
+    // Extract title (first line or heading)
+    const titleMatch = content.match(/^#\s+(.+)$/m) || content.match(/^(.+)$/m);
+    const rawTitle = titleMatch?.[1]?.trim() || 'Untitled';
+    const title = titleTemplate ? titleTemplate.replace('%s', rawTitle) : rawTitle;
+    // Extract description (first paragraph)
+    const paragraphs = content.split('\n\n').filter((p) => !p.startsWith('#'));
+    const rawDescription = paragraphs[0]?.trim().slice(0, 160) || '';
+    const description = descriptionTemplate
+        ? descriptionTemplate.replace('%s', rawDescription)
+        : rawDescription;
+    const metadata = {
+        title,
+        description,
+    };
+    // Add AI attribution if requested
+    if (includeAttribution && aiMetadata) {
+        const attribution = [];
+        if (aiMetadata.provider)
+            attribution.push(`Provider: ${aiMetadata.provider}`);
+        if (aiMetadata.model)
+            attribution.push(`Model: ${aiMetadata.model}`);
+        metadata.other = {
+            'ai-generated': 'true',
+            ...(attribution.length > 0 && { 'ai-attribution': attribution.join(', ') }),
+        };
+    }
+    return metadata;
+}
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

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

package/dist/cjs/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * AI Matey React Next.js
+ *
+ * Next.js integration for AI Matey.
+ *
+ * For server-side utilities, import from 'ai.matey.react.nextjs/server'.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAIMetadata = exports.useCompletion = exports.useChat = void 0;
+// Re-export core hooks for convenience
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "useChat", { enumerable: true, get: function () { return client_js_1.useChat; } });
+Object.defineProperty(exports, "useCompletion", { enumerable: true, get: function () { return client_js_1.useCompletion; } });
+Object.defineProperty(exports, "generateAIMetadata", { enumerable: true, get: function () { return client_js_1.generateAIMetadata; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,uCAAuC;AACvC,yCAAyE;AAAhE,oGAAA,OAAO,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,+GAAA,kBAAkB,OAAA"}

package/dist/cjs/server.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * Next.js Server Utilities
+ *
+ * Server-side utilities for Next.js App Router and API Routes.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStreamingResponse = createStreamingResponse;
+exports.createSSEResponse = createSSEResponse;
+exports.createChatHandler = createChatHandler;
+exports.createChatAction = createChatAction;
+/**
+ * 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);
+ * }
+ * ```
+ */
+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);
+ * }
+ * ```
+ */
+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 });
+ * ```
+ */
+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: [...] });
+ * ```
+ */
+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/cjs/server.js.map

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

package/dist/esm/client.js

@@ -0,0 +1,125 @@
+/**
+ * Next.js Client Utilities
+ *
+ * Client-side hooks and utilities for Next.js.
+ *
+ * @module
+ */
+import { useChat as useChatCore, useCompletion as useCompletionCore } from 'ai.matey.react.core';
+/**
+ * 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 function useChat(options = {}) {
+    const { serverAction, experimental, ...coreOptions } = options;
+    // Default API to Next.js convention
+    const api = coreOptions.api ?? '/api/chat';
+    return useChatCore({
+        ...coreOptions,
+        api,
+        // Use SSE stream protocol by default for Next.js
+        streamProtocol: coreOptions.streamProtocol ?? 'data',
+    });
+}
+/**
+ * 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 function useCompletion(options = {}) {
+    const { serverAction, ...coreOptions } = options;
+    // Default API to Next.js convention
+    const api = coreOptions.api ?? '/api/completion';
+    return useCompletionCore({
+        ...coreOptions,
+        api,
+        streamProtocol: coreOptions.streamProtocol ?? 'data',
+    });
+}
+/**
+ * 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 function generateAIMetadata(content, aiMetadata, options = {}) {
+    const { titleTemplate, descriptionTemplate, includeAttribution = false } = options;
+    // Extract title (first line or heading)
+    const titleMatch = content.match(/^#\s+(.+)$/m) || content.match(/^(.+)$/m);
+    const rawTitle = titleMatch?.[1]?.trim() || 'Untitled';
+    const title = titleTemplate ? titleTemplate.replace('%s', rawTitle) : rawTitle;
+    // Extract description (first paragraph)
+    const paragraphs = content.split('\n\n').filter((p) => !p.startsWith('#'));
+    const rawDescription = paragraphs[0]?.trim().slice(0, 160) || '';
+    const description = descriptionTemplate
+        ? descriptionTemplate.replace('%s', rawDescription)
+        : rawDescription;
+    const metadata = {
+        title,
+        description,
+    };
+    // Add AI attribution if requested
+    if (includeAttribution && aiMetadata) {
+        const attribution = [];
+        if (aiMetadata.provider)
+            attribution.push(`Provider: ${aiMetadata.provider}`);
+        if (aiMetadata.model)
+            attribution.push(`Model: ${aiMetadata.model}`);
+        metadata.other = {
+            'ai-generated': 'true',
+            ...(attribution.length > 0 && { 'ai-attribution': attribution.join(', ') }),
+        };
+    }
+    return metadata;
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,12 @@
+/**
+ * AI Matey React Next.js
+ *
+ * Next.js integration for AI Matey.
+ *
+ * For server-side utilities, import from 'ai.matey.react.nextjs/server'.
+ *
+ * @packageDocumentation
+ */
+// Re-export core hooks for convenience
+export { useChat, useCompletion, generateAIMetadata } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,uCAAuC;AACvC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}