@bernierllc/admin-agent-nextjs 0.0.1 → 0.1.0

package/README.md

@@ -1,45 +1,83 @@
 # @bernierllc/admin-agent-nextjs
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+Thin Next.js App Router adapter that wraps an `AdminAgent` into a streaming SSE POST route handler with auth, validation, and error mapping.
 
-**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/admin-agent-nextjs @bernierllc/admin-agent-service
+```
 
-## Purpose
+Peer dependency: `next >= 14.0.0 < 16`.
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@bernierllc/admin-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?
+```typescript
+// app/api/chat/admin/route.ts
+import { createAdminAgentRouteHandler } from '@bernierllc/admin-agent-nextjs';
+import { adminAgent } from '@/lib/admin-agent';
+import { getServerSession } from 'next-auth';
+import { AdminAgentRouteUnauthorizedError } from '@bernierllc/admin-agent-nextjs';
 
-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.
+export const POST = createAdminAgentRouteHandler({
+  agent: adminAgent,
 
-## Setup Instructions
+  auth: async (request) => {
+    const session = await getServerSession();
+    if (!session?.user) {
+      throw new AdminAgentRouteUnauthorizedError('Not authenticated');
+    }
+    return { userId: session.user.id, orgId: session.user.orgId };
+  },
+});
+```
 
-To properly configure OIDC trusted publishing for this package:
+## API
 
-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
+### `createAdminAgentRouteHandler(config)`
 
-## DO NOT USE THIS PACKAGE
+Returns an `async (request: Request) => Promise<Response>` function suitable for `export const POST` in a Next.js App Router route file.
 
-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
+**Config options:**
 
-## More Information
+| Field | Type | Description |
+|---|---|---|
+| `agent` | `AdminAgent` | Agent instance from `@bernierllc/admin-agent-service` |
+| `auth` | `(request: Request) => Promise<AuthContext>` | Extract auth context; throw `AdminAgentRouteUnauthorizedError` for 401 |
+| `validateBody?` | `(body: unknown) => { message: string }` | Custom body validator; default validates `{ message: string }` |
+| `transformEvent?` | `(event: AdminAgentEvent) => AdminAgentEvent \| null` | Filter or transform events; return `null` to suppress |
 
-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)
+### Errors
 
----
+- `AdminAgentRouteError` — base error class
+- `AdminAgentRouteUnauthorizedError` — throw from `auth()` to produce a 401
+- `AdminAgentRouteBodyError` — throw from `validateBody()` to produce a 400
 
-**Maintained for OIDC setup purposes only**
+### Error-to-HTTP Mapping
+
+| Condition | HTTP Status |
+|---|---|
+| Body parse failure | 400 |
+| `validateBody` throws | 400 |
+| `auth` throws `AdminAgentRouteUnauthorizedError` | 401 |
+| `auth` throws any other error | 500 |
+| Agent initialization failure | 500 |
+| `rate-limited` event received | 200 (stream closes with event) |
+| `feature-disabled` event received | 200 (stream closes with event) |
+
+### Response Format
+
+Streaming `text/plain; charset=utf-8` with `Transfer-Encoding: chunked`. Events are newline-delimited JSON:
+
+```
+{"type":"text-delta","delta":"Hello"}
+{"type":"done"}
+```
+
+## 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,29 @@
+/**
+ * Base error for all admin-agent-nextjs exceptional conditions.
+ *
+ * Uses ES2022 `Error.cause` chaining per the BernierLLC error propagation
+ * standard — underlying errors are never swallowed.
+ */
+export declare class AdminAgentRouteError extends Error {
+    readonly code: string;
+    constructor(message: string, options?: {
+        cause?: Error;
+        code?: string;
+    });
+}
+/**
+ * Thrown (or to be thrown) from the auth function to produce a 401 response.
+ * Consumers throw this from their `auth` callback to signal that the request
+ * is not authenticated.
+ */
+export declare class AdminAgentRouteUnauthorizedError extends AdminAgentRouteError {
+    constructor(message?: string);
+}
+/**
+ * Thrown internally when the request body fails validation.
+ * Results in a 400 response.
+ */
+export declare class AdminAgentRouteBodyError extends AdminAgentRouteError {
+    constructor(detail: string);
+}
+//# 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,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CAOJ;AAED;;;;GAIG;AACH,qBAAa,gCAAiC,SAAQ,oBAAoB;gBAC5D,OAAO,SAAiB;CAKrC;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,oBAAoB;gBACpD,MAAM,EAAE,MAAM;CAK3B"}

package/dist/errors.js

@@ -0,0 +1,52 @@
+"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.AdminAgentRouteBodyError = exports.AdminAgentRouteUnauthorizedError = exports.AdminAgentRouteError = void 0;
+/**
+ * Base error for all admin-agent-nextjs exceptional conditions.
+ *
+ * Uses ES2022 `Error.cause` chaining per the BernierLLC error propagation
+ * standard — underlying errors are never swallowed.
+ */
+class AdminAgentRouteError extends Error {
+    code;
+    constructor(message, options) {
+        super(message, { ...(options?.cause !== undefined ? { cause: options.cause } : {}) });
+        this.name = 'AdminAgentRouteError';
+        this.code = options?.code ?? 'ROUTE_ERROR';
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+exports.AdminAgentRouteError = AdminAgentRouteError;
+/**
+ * Thrown (or to be thrown) from the auth function to produce a 401 response.
+ * Consumers throw this from their `auth` callback to signal that the request
+ * is not authenticated.
+ */
+class AdminAgentRouteUnauthorizedError extends AdminAgentRouteError {
+    constructor(message = 'Unauthorized') {
+        super(message, { code: 'UNAUTHORIZED' });
+        this.name = 'AdminAgentRouteUnauthorizedError';
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+exports.AdminAgentRouteUnauthorizedError = AdminAgentRouteUnauthorizedError;
+/**
+ * Thrown internally when the request body fails validation.
+ * Results in a 400 response.
+ */
+class AdminAgentRouteBodyError extends AdminAgentRouteError {
+    constructor(detail) {
+        super(`Invalid request body: ${detail}`, { code: 'INVALID_BODY' });
+        this.name = 'AdminAgentRouteBodyError';
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+exports.AdminAgentRouteBodyError = AdminAgentRouteBodyError;
+//# 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,oBAAqB,SAAQ,KAAK;IACpC,IAAI,CAAS;IAEtB,YACE,OAAe,EACf,OAGC;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,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,aAAa,CAAC;QAC3C,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;CACF;AAfD,oDAeC;AAED;;;;GAIG;AACH,MAAa,gCAAiC,SAAQ,oBAAoB;IACxE,YAAY,OAAO,GAAG,cAAc;QAClC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;QAC/C,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;CACF;AAND,4EAMC;AAED;;;GAGG;AACH,MAAa,wBAAyB,SAAQ,oBAAoB;IAChE,YAAY,MAAc;QACxB,KAAK,CAAC,yBAAyB,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;CACF;AAND,4DAMC"}

package/dist/handler.d.ts

@@ -0,0 +1,49 @@
+import type { AdminAgent, AuthContext, AdminAgentEvent } from '@bernierllc/admin-agent-service';
+/**
+ * Configuration object for the admin-agent route handler factory.
+ */
+export interface AdminAgentRouteConfig {
+    /**
+     * The AdminAgent instance to delegate chat turns to.
+     * Obtained via `createAdminAgent()` from `@bernierllc/admin-agent-service`.
+     */
+    agent: AdminAgent;
+    /**
+     * Extract and validate auth context from the incoming request.
+     * Throw `AdminAgentRouteUnauthorizedError` to return a 401.
+     * Throw any other error to return a 500.
+     */
+    auth(request: Request): Promise<AuthContext>;
+    /**
+     * Optional body validator. Receives the parsed JSON body and must return
+     * `{ message: string }` or throw `AdminAgentRouteBodyError` for a 400.
+     * Defaults to a simple `{ message: string }` shape check.
+     */
+    validateBody?: (body: unknown) => {
+        message: string;
+    };
+    /**
+     * Optional event transformer. Called for every `AdminAgentEvent` before it
+     * is written to the stream. Return `null` to suppress the event.
+     */
+    transformEvent?: (event: AdminAgentEvent) => AdminAgentEvent | null;
+}
+/**
+ * Creates a Next.js App Router-compatible POST handler that streams
+ * `AdminAgentEvent` objects as newline-delimited JSON.
+ *
+ * Assign directly to `export const POST` in your route file:
+ *
+ * ```typescript
+ * // app/api/chat/admin/route.ts
+ * export const POST = createAdminAgentRouteHandler({
+ *   agent: adminAgent,
+ *   auth: async (req) => getAuthContextFromRequest(req),
+ * });
+ * ```
+ *
+ * @param config - Route configuration including agent, auth, and optional hooks.
+ * @returns An async function `(request: Request) => Promise<Response>`.
+ */
+export declare function createAdminAgentRouteHandler(config: AdminAgentRouteConfig): (request: Request) => 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,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAkBhG;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,EAAE,UAAU,CAAC;IAElB;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7C;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAEtD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,eAAe,GAAG,IAAI,CAAC;CACrE;AAgCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,GAC5B,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA8GzC"}

package/dist/handler.js

@@ -0,0 +1,138 @@
+"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.createAdminAgentRouteHandler = createAdminAgentRouteHandler;
+const logger_1 = require("@bernierllc/logger");
+const errors_1 = require("./errors");
+const log = (0, logger_1.createLogger)();
+const RESPONSE_HEADERS = {
+    'Content-Type': 'text/plain; charset=utf-8',
+    'Transfer-Encoding': 'chunked',
+};
+const JSON_HEADERS = {
+    'Content-Type': 'application/json',
+};
+// ---------------------------------------------------------------------------
+// Default body validator
+// ---------------------------------------------------------------------------
+function defaultValidateBody(body) {
+    if (body === null ||
+        typeof body !== 'object' ||
+        Array.isArray(body) ||
+        typeof body['message'] !== 'string') {
+        throw new errors_1.AdminAgentRouteBodyError('Expected { message: string }');
+    }
+    return { message: body['message'] };
+}
+// ---------------------------------------------------------------------------
+// Encoder
+// ---------------------------------------------------------------------------
+const encoder = new TextEncoder();
+function encodeEvent(event) {
+    return encoder.encode(JSON.stringify(event) + '\n');
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a Next.js App Router-compatible POST handler that streams
+ * `AdminAgentEvent` objects as newline-delimited JSON.
+ *
+ * Assign directly to `export const POST` in your route file:
+ *
+ * ```typescript
+ * // app/api/chat/admin/route.ts
+ * export const POST = createAdminAgentRouteHandler({
+ *   agent: adminAgent,
+ *   auth: async (req) => getAuthContextFromRequest(req),
+ * });
+ * ```
+ *
+ * @param config - Route configuration including agent, auth, and optional hooks.
+ * @returns An async function `(request: Request) => Promise<Response>`.
+ */
+function createAdminAgentRouteHandler(config) {
+    const validate = config.validateBody ?? defaultValidateBody;
+    return async (request) => {
+        // ── 1. Parse JSON body ────────────────────────────────────────────────
+        let body;
+        try {
+            body = await request.json();
+        }
+        catch {
+            return new Response(JSON.stringify({ error: 'Failed to parse request body as JSON' }), { status: 400, headers: JSON_HEADERS });
+        }
+        // ── 2. Validate body ──────────────────────────────────────────────────
+        let validated;
+        try {
+            validated = validate(body);
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : 'Invalid request body';
+            return new Response(JSON.stringify({ error: detail }), { status: 400, headers: JSON_HEADERS });
+        }
+        // ── 3. Auth ───────────────────────────────────────────────────────────
+        let authContext;
+        try {
+            authContext = await config.auth(request);
+        }
+        catch (err) {
+            if (err instanceof errors_1.AdminAgentRouteUnauthorizedError) {
+                return new Response(JSON.stringify({ error: err.message }), { status: 401, headers: JSON_HEADERS });
+            }
+            log.error('[admin-agent-nextjs] Auth error', err instanceof Error ? err : new Error(String(err)));
+            return new Response(JSON.stringify({ error: 'Internal server error' }), { status: 500, headers: JSON_HEADERS });
+        }
+        // ── 4. Peek at first event to catch agent init errors pre-stream ──────
+        const iterable = config.agent.chat(validated.message, authContext, request.signal);
+        const iterator = iterable[Symbol.asyncIterator]();
+        let firstResult;
+        try {
+            firstResult = await iterator.next();
+        }
+        catch (err) {
+            log.error('[admin-agent-nextjs] Agent init error', err instanceof Error ? err : new Error(String(err)));
+            return new Response(JSON.stringify({ error: 'Agent initialization failed' }), { status: 500, headers: JSON_HEADERS });
+        }
+        // ── 5. Stream events ──────────────────────────────────────────────────
+        const { transformEvent } = config;
+        const stream = new ReadableStream({
+            async start(controller) {
+                try {
+                    let current = firstResult;
+                    while (!current.done) {
+                        const event = current.value;
+                        const isTerminal = event.type === 'rate-limited' || event.type === 'feature-disabled';
+                        const transformed = transformEvent !== undefined
+                            ? transformEvent(event)
+                            : event;
+                        if (transformed !== null) {
+                            controller.enqueue(encodeEvent(transformed));
+                        }
+                        if (isTerminal) {
+                            break;
+                        }
+                        current = await iterator.next();
+                    }
+                }
+                catch (err) {
+                    log.error('[admin-agent-nextjs] Stream error', err instanceof Error ? err : new Error(String(err)));
+                }
+                finally {
+                    controller.close();
+                }
+            },
+        });
+        return new Response(stream, {
+            status: 200,
+            headers: RESPONSE_HEADERS,
+        });
+    };
+}
+//# 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,22 @@
+/**
+ * @bernierllc/admin-agent-nextjs
+ *
+ * Thin Next.js App Router adapter that wraps an AdminAgent into a streaming
+ * SSE route handler. Handles request parsing, auth extraction, event
+ * streaming, and error-to-HTTP mapping.
+ *
+ * Quick start:
+ * ```typescript
+ * // app/api/chat/admin/route.ts
+ * import { createAdminAgentRouteHandler } from '@bernierllc/admin-agent-nextjs';
+ *
+ * export const POST = createAdminAgentRouteHandler({
+ *   agent: adminAgent,
+ *   auth: async (req) => getAuthContextFromRequest(req),
+ * });
+ * ```
+ */
+export { createAdminAgentRouteHandler } from './handler';
+export type { AdminAgentRouteConfig } from './handler';
+export { AdminAgentRouteError, AdminAgentRouteUnauthorizedError, AdminAgentRouteBodyError, } 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;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAGvD,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"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.AdminAgentRouteBodyError = exports.AdminAgentRouteUnauthorizedError = exports.AdminAgentRouteError = exports.createAdminAgentRouteHandler = void 0;
+/**
+ * @bernierllc/admin-agent-nextjs
+ *
+ * Thin Next.js App Router adapter that wraps an AdminAgent into a streaming
+ * SSE route handler. Handles request parsing, auth extraction, event
+ * streaming, and error-to-HTTP mapping.
+ *
+ * Quick start:
+ * ```typescript
+ * // app/api/chat/admin/route.ts
+ * import { createAdminAgentRouteHandler } from '@bernierllc/admin-agent-nextjs';
+ *
+ * export const POST = createAdminAgentRouteHandler({
+ *   agent: adminAgent,
+ *   auth: async (req) => getAuthContextFromRequest(req),
+ * });
+ * ```
+ */
+// ── Public API ────────────────────────────────────────────────────────────────
+var handler_1 = require("./handler");
+Object.defineProperty(exports, "createAdminAgentRouteHandler", { enumerable: true, get: function () { return handler_1.createAdminAgentRouteHandler; } });
+// ── Errors ────────────────────────────────────────────────────────────────────
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "AdminAgentRouteError", { enumerable: true, get: function () { return errors_1.AdminAgentRouteError; } });
+Object.defineProperty(exports, "AdminAgentRouteUnauthorizedError", { enumerable: true, get: function () { return errors_1.AdminAgentRouteUnauthorizedError; } });
+Object.defineProperty(exports, "AdminAgentRouteBodyError", { enumerable: true, get: function () { return errors_1.AdminAgentRouteBodyError; } });
+//# 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;;;;;;;;;;;;;;;;;GAiBG;AAEH,iFAAiF;AACjF,qCAAyD;AAAhD,uHAAA,4BAA4B,OAAA;AAGrC,iFAAiF;AACjF,mCAIkB;AAHhB,8GAAA,oBAAoB,OAAA;AACpB,0HAAA,gCAAgC,OAAA;AAChC,kHAAA,wBAAwB,OAAA"}

package/package.json

@@ -1,10 +1,71 @@
 {
   "name": "@bernierllc/admin-agent-nextjs",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @bernierllc/admin-agent-nextjs",
+  "version": "0.1.0",
+  "description": "Next.js App Router adapter for admin-agent-service: streaming SSE POST handler with auth, validation, and error mapping",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "browser": false,
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "admin-agent",
+    "nextjs",
+    "app-router",
+    "streaming",
+    "sse",
+    "adapter",
+    "bernierllc"
+  ],
+  "author": "Bernier LLC",
+  "license": "Bernier LLC",
+  "dependencies": {
+    "@bernierllc/logger": "^1.7.0",
+    "@bernierllc/admin-agent-service": "0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0 <16"
+  },
+  "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"
+  }
+}