@bernierllc/onboarding-agent-nextjs 0.0.1 → 0.1.0

package/README.md

@@ -1,45 +1,109 @@
 # @bernierllc/onboarding-agent-nextjs
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+Thin Next.js App Router adapter that wraps `OnboardingAgent` into streaming SSE route handlers compatible with the Vercel AI SDK v6 and `onboarding-chat-ui`.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## Installation
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+```bash
+npm install @bernierllc/onboarding-agent-nextjs @bernierllc/onboarding-agent-service
+```
 
-## Purpose
+Peer dependency: `next ^14.0.0 || ^15.0.0`.
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@bernierllc/onboarding-agent-nextjs`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+## Usage
 
-## What is OIDC Trusted Publishing?
+### Chat Handler (SSE streaming)
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+```typescript
+// app/api/onboarding/chat/route.ts
+import { createOnboardingRouteHandler } from '@bernierllc/onboarding-agent-nextjs';
+import { agent } from '@/lib/onboarding-agent';
+import { getServerSession } from 'next-auth';
+import type { NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
 
-## Setup Instructions
+export const POST = createOnboardingRouteHandler(agent, {
+  auth: async (req: NextRequest) => {
+    const session = await getServerSession();
+    if (!session?.user) {
+      return new NextResponse(JSON.stringify({ error: 'Unauthorized' }), { status: 401 });
+    }
+    return { userId: session.user.id, sessionId: session.user.orgId };
+  },
+});
+```
 
-To properly configure OIDC trusted publishing for this package:
+### Status Handler
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+```typescript
+// app/api/onboarding/status/route.ts
+import { createStatusRouteHandler } from '@bernierllc/onboarding-agent-nextjs';
+import { agent } from '@/lib/onboarding-agent';
 
-## DO NOT USE THIS PACKAGE
+export const GET = createStatusRouteHandler(agent);
+```
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+### Rating Handler
 
-## More Information
+```typescript
+// app/api/onboarding/rating/route.ts
+import { createRatingRouteHandler } from '@bernierllc/onboarding-agent-nextjs';
+import { agent } from '@/lib/onboarding-agent';
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+export const POST = createRatingRouteHandler(agent);
+```
 
----
+## API
 
-**Maintained for OIDC setup purposes only**
+### `createOnboardingRouteHandler(agent, options?)`
+
+Returns a `POST` handler that streams `OnboardingAgent.chat()` output as SSE events.
+
+**Streaming format** (Vercel AI SDK v6 compatible):
+
+```
+data: {"type":"text-delta","delta":"Hello"}
+
+data: {"type":"done"}
+
+data: [DONE]
+
+```
+
+**Attachment extraction:** Accepts both JSON `{ attachments: [{ filename, dataUrl, mimeType }] }` and `multipart/form-data` with `files[]` fields (converted to base64 data URLs).
+
+### `createStatusRouteHandler(agent, options?)`
+
+Returns a `GET` handler that calls `agent.getSetupStatus(sessionId)` and returns JSON.
+
+### `createRatingRouteHandler(agent, options?)`
+
+Returns a `POST` handler that accepts `{ rating: 'up' | 'down' }` and calls `agent.recordRating(sessionId, rating)`.
+
+### `OnboardingRouteOptions`
+
+| Field | Type | Description |
+|---|---|---|
+| `auth?` | `(req: NextRequest) => Promise<{ userId, sessionId } \| NextResponse>` | Optional auth middleware. Return `NextResponse` to block the request. |
+| `contentType?` | `string` | Override SSE content-type. Default: `text/event-stream`. |
+
+### HTTP Error Mapping
+
+| OnboardingAgentError code | HTTP status |
+|---|---|
+| `ONBOARDING_AGENT_INIT_ERROR` | 503 |
+| `ONBOARDING_HANDOFF_ERROR` | 500 |
+| `ONBOARDING_CONFIG_VALIDATION_ERROR` | 400 |
+| `ONBOARDING_PLUGIN_ERROR` | 400 |
+| Any other `OnboardingAgentError` | 500 |
+| Non-OnboardingAgentError | 500 |
+
+Error response body: `{ error: string, code?: string }`.
+
+## Node.js Only
+
+This package requires a Node.js server runtime. It is not browser-safe.
+
+## License
+
+Copyright (c) 2025 Bernier LLC. All rights reserved.

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Error class for all onboarding-agent-nextjs exceptional conditions.
+ *
+ * Uses ES2022 `Error.cause` chaining per the BernierLLC error propagation
+ * standard — underlying errors are never swallowed.
+ */
+export declare class OnboardingNextjsError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options?: {
+        cause?: Error;
+        code?: string;
+        context?: Record<string, unknown>;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAUJ"}

package/dist/errors.js

@@ -0,0 +1,31 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnboardingNextjsError = void 0;
+/**
+ * Error class for all onboarding-agent-nextjs exceptional conditions.
+ *
+ * Uses ES2022 `Error.cause` chaining per the BernierLLC error propagation
+ * standard — underlying errors are never swallowed.
+ */
+class OnboardingNextjsError extends Error {
+    code;
+    context;
+    constructor(message, options) {
+        super(message, { ...(options?.cause !== undefined ? { cause: options.cause } : {}) });
+        this.name = 'OnboardingNextjsError';
+        this.code = options?.code ?? 'ONBOARDING_NEXTJS_ERROR';
+        if (options?.context !== undefined) {
+            this.context = options.context;
+        }
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+exports.OnboardingNextjsError = OnboardingNextjsError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF;;;;;GAKG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IACrC,IAAI,CAAS;IACb,OAAO,CAA2B;IAE3C,YACE,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,yBAAyB,CAAC;QACvD,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;CACF;AApBD,sDAoBC"}

package/dist/handler.d.ts

@@ -0,0 +1,65 @@
+import type { NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
+import type { OnboardingAgent } from '@bernierllc/onboarding-agent-service';
+/**
+ * Options shared by all onboarding route handlers.
+ */
+export interface OnboardingRouteOptions {
+    /**
+     * Optional auth middleware. Called before each request.
+     * Return `{ userId, sessionId }` to allow the request.
+     * Return a `NextResponse` (e.g. 401/403) to block the request immediately.
+     */
+    auth?: (req: NextRequest) => Promise<{
+        userId: string;
+        sessionId: string;
+    } | NextResponse>;
+    /**
+     * Override the streaming content-type.
+     * Default: `'text/event-stream'`.
+     */
+    contentType?: string;
+}
+/**
+ * Creates a Next.js App Router POST handler that streams `OnboardingAgent`
+ * responses as Server-Sent Events (SSE), compatible with Vercel AI SDK v6.
+ *
+ * Handles both JSON and `multipart/form-data` request bodies, auth middleware,
+ * attachment extraction, and HTTP error mapping.
+ *
+ * ```typescript
+ * // app/api/onboarding/chat/route.ts
+ * export const POST = createOnboardingRouteHandler(agent, {
+ *   auth: async (req) => getSessionFromRequest(req),
+ * });
+ * ```
+ */
+export declare function createOnboardingRouteHandler(agent: OnboardingAgent, options?: OnboardingRouteOptions): (req: NextRequest) => Promise<Response>;
+/**
+ * Creates a Next.js App Router GET handler that returns the current
+ * onboarding goal progress for a session as JSON.
+ *
+ * The session id is sourced from the auth function when provided, or from
+ * the `sessionId` query parameter otherwise.
+ *
+ * ```typescript
+ * // app/api/onboarding/status/route.ts
+ * export const GET = createStatusRouteHandler(agent, { auth });
+ * ```
+ */
+export declare function createStatusRouteHandler(agent: OnboardingAgent, options?: Pick<OnboardingRouteOptions, 'auth'>): (req: NextRequest) => Promise<Response>;
+/**
+ * Creates a Next.js App Router POST handler that records a thumbs-up or
+ * thumbs-down rating for the most recent conversation in a session.
+ *
+ * Expected body: `{ rating: 'up' | 'down', sessionId?: string }`.
+ * The session id is sourced from the auth function when provided, or from
+ * the request body otherwise.
+ *
+ * ```typescript
+ * // app/api/onboarding/rating/route.ts
+ * export const POST = createRatingRouteHandler(agent, { auth });
+ * ```
+ */
+export declare function createRatingRouteHandler(agent: OnboardingAgent, options?: Pick<OnboardingRouteOptions, 'auth'>): (req: NextRequest) => Promise<Response>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,sCAAsC,CAAC;AAUnG;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAAC,CAAC;IAE3F;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAyGD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAoFzC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,GAC7C,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAsCzC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,GAC7C,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CA0DzC"}

package/dist/handler.js

@@ -0,0 +1,299 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOnboardingRouteHandler = createOnboardingRouteHandler;
+exports.createStatusRouteHandler = createStatusRouteHandler;
+exports.createRatingRouteHandler = createRatingRouteHandler;
+const server_1 = require("next/server");
+const onboarding_agent_service_1 = require("@bernierllc/onboarding-agent-service");
+const logger_1 = require("@bernierllc/logger");
+const log = (0, logger_1.createLogger)();
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+const encoder = new TextEncoder();
+function sseChunk(chunk) {
+    return encoder.encode(`data: ${JSON.stringify(chunk)}\n\n`);
+}
+const SSE_DONE = encoder.encode('data: [DONE]\n\n');
+function jsonError(message, code, status = 500) {
+    const body = { error: message };
+    if (code !== undefined) {
+        body['code'] = code;
+    }
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
+/**
+ * Map an `OnboardingAgentError` code to an HTTP status code.
+ */
+function agentErrorStatus(err) {
+    switch (err.code) {
+        case 'ONBOARDING_AGENT_INIT_ERROR':
+            return 503;
+        case 'ONBOARDING_HANDOFF_ERROR':
+            return 500;
+        case 'ONBOARDING_CONFIG_VALIDATION_ERROR':
+        case 'ONBOARDING_PLUGIN_ERROR':
+            return 400;
+        default:
+            return 500;
+    }
+}
+/**
+ * Run auth middleware if provided. Returns `{ userId, sessionId }` on success,
+ * or a `Response` to return immediately.
+ */
+async function runAuth(req, auth) {
+    if (auth === undefined) {
+        return { userId: 'anonymous', sessionId: 'default' };
+    }
+    const result = await auth(req);
+    if (result instanceof server_1.NextResponse) {
+        return result;
+    }
+    return result;
+}
+/**
+ * Extract `Attachment` objects from a JSON request body.
+ */
+function extractJsonAttachments(raw) {
+    return raw.map((item) => {
+        const a = item;
+        return {
+            filename: String(a['filename'] ?? ''),
+            dataUrl: String(a['dataUrl'] ?? ''),
+            mimeType: String(a['mimeType'] ?? ''),
+        };
+    });
+}
+/**
+ * Extract `Attachment` objects from a `FormData` `files[]` field.
+ * Each file is read as an ArrayBuffer and encoded as a base64 data URL.
+ */
+async function extractMultipartAttachments(formData) {
+    const files = formData.getAll('files[]');
+    const attachments = [];
+    for (const file of files) {
+        if (!(file instanceof File))
+            continue;
+        const buffer = await file.arrayBuffer();
+        const base64 = Buffer.from(buffer).toString('base64');
+        const dataUrl = `data:${file.type};base64,${base64}`;
+        attachments.push({
+            filename: file.name,
+            dataUrl,
+            mimeType: file.type,
+        });
+    }
+    return attachments;
+}
+// ---------------------------------------------------------------------------
+// createOnboardingRouteHandler
+// ---------------------------------------------------------------------------
+/**
+ * Creates a Next.js App Router POST handler that streams `OnboardingAgent`
+ * responses as Server-Sent Events (SSE), compatible with Vercel AI SDK v6.
+ *
+ * Handles both JSON and `multipart/form-data` request bodies, auth middleware,
+ * attachment extraction, and HTTP error mapping.
+ *
+ * ```typescript
+ * // app/api/onboarding/chat/route.ts
+ * export const POST = createOnboardingRouteHandler(agent, {
+ *   auth: async (req) => getSessionFromRequest(req),
+ * });
+ * ```
+ */
+function createOnboardingRouteHandler(agent, options) {
+    const contentType = options?.contentType ?? 'text/event-stream';
+    return async (req) => {
+        // ── Auth ─────────────────────────────────────────────────────────────────
+        const authResult = await runAuth(req, options?.auth);
+        if (authResult instanceof Response) {
+            return authResult;
+        }
+        const { userId, sessionId } = authResult;
+        // ── Body parsing ─────────────────────────────────────────────────────────
+        let message;
+        let attachments;
+        const reqContentType = req.headers.get('content-type') ?? '';
+        try {
+            if (reqContentType.includes('multipart/form-data')) {
+                const formData = await req.formData();
+                message = String(formData.get('message') ?? '');
+                attachments = await extractMultipartAttachments(formData);
+            }
+            else {
+                const body = await req.json();
+                message = String(body['message'] ?? '');
+                const rawAttachments = body['attachments'];
+                if (Array.isArray(rawAttachments) && rawAttachments.length > 0) {
+                    attachments = extractJsonAttachments(rawAttachments);
+                }
+            }
+        }
+        catch (err) {
+            log.error('[onboarding-agent-nextjs] Body parse error', err instanceof Error ? err : new Error(String(err)));
+            return jsonError('Failed to parse request body', undefined, 400);
+        }
+        // ── Stream ───────────────────────────────────────────────────────────────
+        const stream = new ReadableStream({
+            async start(controller) {
+                try {
+                    const input = {
+                        sessionId,
+                        userId,
+                        message,
+                        ...(attachments !== undefined ? { attachments } : {}),
+                    };
+                    for await (const chunk of agent.chat(input)) {
+                        controller.enqueue(sseChunk(chunk));
+                    }
+                    controller.enqueue(SSE_DONE);
+                }
+                catch (err) {
+                    log.error('[onboarding-agent-nextjs] Stream error', err instanceof Error ? err : new Error(String(err)));
+                    if (err instanceof onboarding_agent_service_1.OnboardingAgentError) {
+                        const status = agentErrorStatus(err);
+                        const errBytes = encoder.encode(`data: ${JSON.stringify({ error: err.message, code: err.code })}\n\n`);
+                        controller.enqueue(errBytes);
+                        // status is already 200 (streaming started)
+                        log.error(`[onboarding-agent-nextjs] OnboardingAgentError (${err.code}) mapped to ${status}`);
+                    }
+                }
+                finally {
+                    controller.close();
+                }
+            },
+        });
+        return new Response(stream, {
+            status: 200,
+            headers: {
+                'Content-Type': contentType,
+                'Cache-Control': 'no-cache',
+                Connection: 'keep-alive',
+            },
+        });
+    };
+}
+// ---------------------------------------------------------------------------
+// createStatusRouteHandler
+// ---------------------------------------------------------------------------
+/**
+ * Creates a Next.js App Router GET handler that returns the current
+ * onboarding goal progress for a session as JSON.
+ *
+ * The session id is sourced from the auth function when provided, or from
+ * the `sessionId` query parameter otherwise.
+ *
+ * ```typescript
+ * // app/api/onboarding/status/route.ts
+ * export const GET = createStatusRouteHandler(agent, { auth });
+ * ```
+ */
+function createStatusRouteHandler(agent, options) {
+    return async (req) => {
+        // ── Auth ─────────────────────────────────────────────────────────────────
+        const authResult = await runAuth(req, options?.auth);
+        if (authResult instanceof Response) {
+            return authResult;
+        }
+        // sessionId: from auth or from query param
+        let sessionId = authResult.sessionId;
+        if (sessionId === 'default' && options?.auth === undefined) {
+            const paramSessionId = req.nextUrl.searchParams.get('sessionId');
+            if (paramSessionId !== null) {
+                sessionId = paramSessionId;
+            }
+        }
+        // ── Delegate to agent ────────────────────────────────────────────────────
+        try {
+            const status = await agent.getSetupStatus(sessionId);
+            return new Response(JSON.stringify(status), {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        catch (err) {
+            log.error('[onboarding-agent-nextjs] Status error', err instanceof Error ? err : new Error(String(err)));
+            if (err instanceof onboarding_agent_service_1.OnboardingAgentError) {
+                const status = agentErrorStatus(err);
+                return jsonError(err.message, err.code, status);
+            }
+            return jsonError('Internal server error', undefined, 500);
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// createRatingRouteHandler
+// ---------------------------------------------------------------------------
+/**
+ * Creates a Next.js App Router POST handler that records a thumbs-up or
+ * thumbs-down rating for the most recent conversation in a session.
+ *
+ * Expected body: `{ rating: 'up' | 'down', sessionId?: string }`.
+ * The session id is sourced from the auth function when provided, or from
+ * the request body otherwise.
+ *
+ * ```typescript
+ * // app/api/onboarding/rating/route.ts
+ * export const POST = createRatingRouteHandler(agent, { auth });
+ * ```
+ */
+function createRatingRouteHandler(agent, options) {
+    return async (req) => {
+        // ── Auth ─────────────────────────────────────────────────────────────────
+        const authResult = await runAuth(req, options?.auth);
+        if (authResult instanceof Response) {
+            return authResult;
+        }
+        // ── Parse body ───────────────────────────────────────────────────────────
+        let rating;
+        let sessionId = authResult.sessionId;
+        try {
+            const body = await req.json();
+            const rawRating = body['rating'];
+            if (rawRating !== 'up' && rawRating !== 'down') {
+                return jsonError('rating must be "up" or "down"', undefined, 400);
+            }
+            rating = rawRating;
+            // Override sessionId from body when no auth provided
+            if (sessionId === 'default' && options?.auth === undefined) {
+                const bodySessionId = body['sessionId'];
+                if (typeof bodySessionId === 'string') {
+                    sessionId = bodySessionId;
+                }
+            }
+        }
+        catch (err) {
+            log.error('[onboarding-agent-nextjs] Rating body parse error', err instanceof Error ? err : new Error(String(err)));
+            return jsonError('Failed to parse request body', undefined, 400);
+        }
+        // ── Delegate to agent ────────────────────────────────────────────────────
+        try {
+            await agent.recordRating(sessionId, rating);
+            return new Response(JSON.stringify({ success: true }), {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        catch (err) {
+            log.error('[onboarding-agent-nextjs] Rating error', err instanceof Error ? err : new Error(String(err)));
+            if (err instanceof onboarding_agent_service_1.OnboardingAgentError) {
+                const status = agentErrorStatus(err);
+                return jsonError(err.message, err.code, status);
+            }
+            return jsonError('Internal server error', undefined, 500);
+        }
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @bernierllc/onboarding-agent-nextjs
+ *
+ * Thin Next.js App Router adapter that wraps `OnboardingAgent` into streaming
+ * SSE route handlers compatible with the Vercel AI SDK.
+ *
+ * Quick start:
+ * ```typescript
+ * // app/api/onboarding/chat/route.ts
+ * import { createOnboardingRouteHandler } from '@bernierllc/onboarding-agent-nextjs';
+ * export const POST = createOnboardingRouteHandler(agent, { auth });
+ *
+ * // app/api/onboarding/status/route.ts
+ * import { createStatusRouteHandler } from '@bernierllc/onboarding-agent-nextjs';
+ * export const GET = createStatusRouteHandler(agent);
+ *
+ * // app/api/onboarding/rating/route.ts
+ * import { createRatingRouteHandler } from '@bernierllc/onboarding-agent-nextjs';
+ * export const POST = createRatingRouteHandler(agent);
+ * ```
+ */
+export { createOnboardingRouteHandler, createStatusRouteHandler, createRatingRouteHandler, } from './handler';
+export type { OnboardingRouteOptions } from './handler';
+export { OnboardingNextjsError } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAGxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnboardingNextjsError = exports.createRatingRouteHandler = exports.createStatusRouteHandler = exports.createOnboardingRouteHandler = void 0;
+/**
+ * @bernierllc/onboarding-agent-nextjs
+ *
+ * Thin Next.js App Router adapter that wraps `OnboardingAgent` into streaming
+ * SSE route handlers compatible with the Vercel AI SDK.
+ *
+ * Quick start:
+ * ```typescript
+ * // app/api/onboarding/chat/route.ts
+ * import { createOnboardingRouteHandler } from '@bernierllc/onboarding-agent-nextjs';
+ * export const POST = createOnboardingRouteHandler(agent, { auth });
+ *
+ * // app/api/onboarding/status/route.ts
+ * import { createStatusRouteHandler } from '@bernierllc/onboarding-agent-nextjs';
+ * export const GET = createStatusRouteHandler(agent);
+ *
+ * // app/api/onboarding/rating/route.ts
+ * import { createRatingRouteHandler } from '@bernierllc/onboarding-agent-nextjs';
+ * export const POST = createRatingRouteHandler(agent);
+ * ```
+ */
+// ── Public API ────────────────────────────────────────────────────────────────
+var handler_1 = require("./handler");
+Object.defineProperty(exports, "createOnboardingRouteHandler", { enumerable: true, get: function () { return handler_1.createOnboardingRouteHandler; } });
+Object.defineProperty(exports, "createStatusRouteHandler", { enumerable: true, get: function () { return handler_1.createStatusRouteHandler; } });
+Object.defineProperty(exports, "createRatingRouteHandler", { enumerable: true, get: function () { return handler_1.createRatingRouteHandler; } });
+// ── Errors ────────────────────────────────────────────────────────────────────
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "OnboardingNextjsError", { enumerable: true, get: function () { return errors_1.OnboardingNextjsError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,iFAAiF;AACjF,qCAImB;AAHjB,uHAAA,4BAA4B,OAAA;AAC5B,mHAAA,wBAAwB,OAAA;AACxB,mHAAA,wBAAwB,OAAA;AAI1B,iFAAiF;AACjF,mCAAiD;AAAxC,+GAAA,qBAAqB,OAAA"}

package/package.json

@@ -1,10 +1,71 @@
 {
   "name": "@bernierllc/onboarding-agent-nextjs",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @bernierllc/onboarding-agent-nextjs",
+  "version": "0.1.0",
+  "description": "Next.js App Router adapter for OnboardingAgent: streaming SSE route handler, attachment extraction, and auth middleware.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "browser": false,
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "onboarding-agent",
+    "nextjs",
+    "app-router",
+    "streaming",
+    "sse",
+    "adapter",
+    "bernierllc"
+  ],
+  "author": "Bernier LLC",
+  "license": "Bernier LLC",
+  "dependencies": {
+    "@bernierllc/logger": "^1.7.0",
+    "@bernierllc/onboarding-agent-service": "0.1.0"
+  },
+  "peerDependencies": {
+    "next": "^14.0.0 || ^15.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "@types/node": "^20.6.0",
+    "jest": "^29.6.4",
+    "next": "^15.0.0",
+    "rimraf": "^5.0.1",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.2.2"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bernier-llc/tools.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "bernierllc": {
+    "runtime": "node",
+    "category": "service",
+    "integration": {
+      "neverhub": "not-applicable",
+      "neveradmin": "not-applicable",
+      "logger": "integrated"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:run": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean"
+  }
+}