@byline/host-tanstack-start 1.8.2 → 1.9.0

package/dist/integrations/byline-ai.d.ts

@@ -0,0 +1,34 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+/**
+ * Bridges the `@byline/ai` plugins to TanStack Start's RPC transport.
+ *
+ * The plugins make `fetch(endpoint, init)` calls. We substitute a
+ * fetch-shaped adapter that invokes `executeAiInstruction` (a server
+ * function with admin-auth enforcement) and returns its `Response` —
+ * preserving the NDJSON streaming wire format the plugins already
+ * understand.
+ *
+ * Hosts mount `<BylineAiAdminProvider>` once inside the admin shell.
+ */
+import type { ReactNode } from 'react';
+/**
+ * `fetch`-shaped adapter that dispatches the body to the
+ * `executeAiInstruction` server function. The `input` URL is ignored —
+ * the server function handles routing and auth.
+ */
+export declare const aiFetchAdapter: typeof fetch;
+/**
+ * Single-line provider mount for the admin shell. Wires `@byline/ai`'s
+ * public config to the host-side server function. Set `enabled={false}`
+ * to allow wrapper fields to hide AI affordances globally.
+ */
+export declare function BylineAiAdminProvider({ children, enabled, }: {
+    children: ReactNode;
+    enabled?: boolean;
+}): import("react").JSX.Element;

package/dist/integrations/byline-ai.js

@@ -0,0 +1,33 @@
+import { jsx } from "react/jsx-runtime";
+import { AiPublicConfigProvider } from "@byline/ai";
+import { executeAiInstruction } from "../server-fns/ai/index.js";
+const aiFetchAdapter = async (_input, init)=>{
+    const bodyText = 'string' == typeof init?.body ? init.body : init?.body == null ? '' : await new Response(init.body).text();
+    let payload;
+    try {
+        payload = JSON.parse(bodyText);
+    } catch  {
+        return new Response(JSON.stringify({
+            error: 'Invalid JSON payload'
+        }), {
+            status: 400,
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        });
+    }
+    return executeAiInstruction({
+        data: payload,
+        signal: init?.signal ?? void 0
+    });
+};
+function BylineAiAdminProvider({ children, enabled }) {
+    return /*#__PURE__*/ jsx(AiPublicConfigProvider, {
+        config: {
+            fetch: aiFetchAdapter,
+            enabled
+        },
+        children: children
+    });
+}
+export { BylineAiAdminProvider, aiFetchAdapter };

package/dist/routes/create-admin-layout-route.js

@@ -10,6 +10,7 @@ import { AdminMenuDrawer } from "../admin-shell/chrome/menu-drawer.js";
 import { AdminMenuProvider } from "../admin-shell/chrome/menu-provider.js";
 import { RouteError, RouteNotFound } from "../admin-shell/chrome/route-error.js";
 import { bylineAdminServices } from "../integrations/byline-admin-services.js";
+import { BylineAiAdminProvider } from "../integrations/byline-ai.js";
 import { bylineFieldServices } from "../integrations/byline-field-services.js";
 import { getCurrentAdminUser } from "../server-fns/auth/index.js";
 function createAdminLayoutRoute(path, opts = {}) {
@@ -36,22 +37,24 @@ function createAdminLayoutRoute(path, opts = {}) {
                 services: bylineAdminServices,
                 children: /*#__PURE__*/ jsx(BylineFieldServicesProvider, {
                     services: bylineFieldServices,
-                    children: /*#__PURE__*/ jsxs(AdminMenuProvider, {
-                        children: [
-                            /*#__PURE__*/ jsx(AdminAppBar, {
-                                user: user
-                            }),
-                            /*#__PURE__*/ jsxs("main", {
-                                className: classnames('byline-admin-layout-main', admin_layout_module.main),
-                                children: [
-                                    /*#__PURE__*/ jsx(DrawerToggle, {}),
-                                    /*#__PURE__*/ jsx(AdminMenuDrawer, {}),
-                                    /*#__PURE__*/ jsx(Content, {
-                                        children: /*#__PURE__*/ jsx(Outlet, {})
-                                    })
-                                ]
-                            })
-                        ]
+                    children: /*#__PURE__*/ jsx(BylineAiAdminProvider, {
+                        children: /*#__PURE__*/ jsxs(AdminMenuProvider, {
+                            children: [
+                                /*#__PURE__*/ jsx(AdminAppBar, {
+                                    user: user
+                                }),
+                                /*#__PURE__*/ jsxs("main", {
+                                    className: classnames('byline-admin-layout-main', admin_layout_module.main),
+                                    children: [
+                                        /*#__PURE__*/ jsx(DrawerToggle, {}),
+                                        /*#__PURE__*/ jsx(AdminMenuDrawer, {}),
+                                        /*#__PURE__*/ jsx(Content, {
+                                            children: /*#__PURE__*/ jsx(Outlet, {})
+                                        })
+                                    ]
+                                })
+                            ]
+                        })
                     })
                 })
             });

package/dist/server-fns/ai/execute.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { ExecuteInstructionOptions, ExecuteInstructionParams } from '@byline/ai';
+/**
+ * Wire shape — the same as `ExecuteInstruction` minus the in-process-only
+ * `signal` (an AbortSignal can't be serialized across the RPC boundary;
+ * the client passes its signal separately as a fetcher option).
+ */
+type ExecuteAiInstructionInput = {
+    params: ExecuteInstructionParams;
+    options?: Omit<ExecuteInstructionOptions, 'signal'>;
+};
+export declare const executeAiInstruction: import("@tanstack/react-start").RequiredFetcher<undefined, (input: ExecuteAiInstructionInput) => ExecuteAiInstructionInput, Promise<Response>>;
+export {};

package/dist/server-fns/ai/execute.js

@@ -0,0 +1,49 @@
+import { createServerFn } from "@tanstack/react-start";
+import { executeInstruction, executeInstructionStreaming } from "@byline/ai/server";
+import { getAdminRequestContext } from "../../auth/auth-context.js";
+const executeAiInstruction = createServerFn({
+    method: 'POST'
+}).inputValidator((input)=>input).handler(async ({ data })=>{
+    await getAdminRequestContext();
+    if (data.options?.streaming) {
+        const streamResult = executeInstructionStreaming(data.params, data.options);
+        const ndjson = new ReadableStream({
+            async start (controller) {
+                const encoder = new TextEncoder();
+                const enqueue = (obj)=>{
+                    controller.enqueue(encoder.encode(`${JSON.stringify(obj)}\n`));
+                };
+                try {
+                    for await (const chunk of streamResult.text)enqueue({
+                        type: 'delta',
+                        text: chunk
+                    });
+                    const finalState = await streamResult.final;
+                    enqueue({
+                        type: 'final',
+                        state: finalState
+                    });
+                } catch (err) {
+                    enqueue({
+                        type: 'error',
+                        message: err instanceof Error ? err.message : 'AI stream error'
+                    });
+                } finally{
+                    controller.close();
+                }
+            }
+        });
+        return new Response(ndjson, {
+            headers: {
+                'Content-Type': 'application/x-ndjson; charset=utf-8'
+            }
+        });
+    }
+    const state = await executeInstruction(data.params, data.options);
+    return new Response(JSON.stringify(state), {
+        headers: {
+            'Content-Type': 'application/json; charset=utf-8'
+        }
+    });
+});
+export { executeAiInstruction };

package/dist/server-fns/ai/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+/**
+ * Admin-only AI server functions backing the `@byline/ai` plugins.
+ *
+ * The plugins use a `fetch`-shaped API; the host adapter ships a
+ * `aiFetchAdapter` in `@byline/host-tanstack-start/integrations/byline-ai`
+ * that wraps `executeAiInstruction` so the plugins remain transport-agnostic.
+ */
+export { executeAiInstruction } from './execute';

package/dist/server-fns/ai/index.js

@@ -0,0 +1 @@
+export { executeAiInstruction } from "./execute.js";

package/package.json

@@ -3,7 +3,7 @@
   "private": false,
   "type": "module",
   "license": "MPL-2.0",
-  "version": "1.8.2",
+  "version": "1.9.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -45,6 +45,10 @@
       "types": "./dist/server-fns/admin-account/index.d.ts",
       "import": "./dist/server-fns/admin-account/index.js"
     },
+    "./server-fns/ai": {
+      "types": "./dist/server-fns/ai/index.d.ts",
+      "import": "./dist/server-fns/ai/index.js"
+    },
     "./server-fns/admin-permissions": {
       "types": "./dist/server-fns/admin-permissions/index.d.ts",
       "import": "./dist/server-fns/admin-permissions/index.js"
@@ -101,11 +105,12 @@
     "react-swipeable": "^7.0.2",
     "uuid": "^14.0.0",
     "zod": "^4.4.2",
-    "@byline/auth": "1.8.2",
-    "@byline/core": "1.8.2",
-    "@byline/client": "1.8.2",
-    "@byline/admin": "1.8.2",
-    "@byline/ui": "1.8.2"
+    "@byline/admin": "1.9.0",
+    "@byline/ai": "1.9.0",
+    "@byline/client": "1.9.0",
+    "@byline/core": "1.9.0",
+    "@byline/auth": "1.9.0",
+    "@byline/ui": "1.9.0"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.167.0",

package/src/integrations/byline-ai.tsx

@@ -0,0 +1,82 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+/**
+ * Bridges the `@byline/ai` plugins to TanStack Start's RPC transport.
+ *
+ * The plugins make `fetch(endpoint, init)` calls. We substitute a
+ * fetch-shaped adapter that invokes `executeAiInstruction` (a server
+ * function with admin-auth enforcement) and returns its `Response` —
+ * preserving the NDJSON streaming wire format the plugins already
+ * understand.
+ *
+ * Hosts mount `<BylineAiAdminProvider>` once inside the admin shell.
+ */
+
+import type { ReactNode } from 'react'
+
+import {
+  AiPublicConfigProvider,
+  type ExecuteInstructionOptions,
+  type ExecuteInstructionParams,
+} from '@byline/ai'
+
+import { executeAiInstruction } from '../server-fns/ai/index.js'
+
+type ExecuteAiInstructionWire = {
+  params: ExecuteInstructionParams
+  options?: Omit<ExecuteInstructionOptions, 'signal'>
+}
+
+/**
+ * `fetch`-shaped adapter that dispatches the body to the
+ * `executeAiInstruction` server function. The `input` URL is ignored —
+ * the server function handles routing and auth.
+ */
+export const aiFetchAdapter: typeof fetch = async (_input, init) => {
+  const bodyText =
+    typeof init?.body === 'string'
+      ? init.body
+      : init?.body == null
+        ? ''
+        : await new Response(init.body as BodyInit).text()
+
+  let payload: ExecuteAiInstructionWire
+  try {
+    payload = JSON.parse(bodyText) as ExecuteAiInstructionWire
+  } catch {
+    return new Response(JSON.stringify({ error: 'Invalid JSON payload' }), {
+      status: 400,
+      headers: { 'Content-Type': 'application/json' },
+    })
+  }
+
+  return executeAiInstruction({
+    data: payload,
+    signal: init?.signal ?? undefined,
+  })
+}
+
+/**
+ * Single-line provider mount for the admin shell. Wires `@byline/ai`'s
+ * public config to the host-side server function. Set `enabled={false}`
+ * to allow wrapper fields to hide AI affordances globally.
+ */
+export function BylineAiAdminProvider({
+  children,
+  enabled,
+}: {
+  children: ReactNode
+  enabled?: boolean
+}) {
+  return (
+    <AiPublicConfigProvider config={{ fetch: aiFetchAdapter, enabled }}>
+      {children}
+    </AiPublicConfigProvider>
+  )
+}

package/src/routes/create-admin-layout-route.tsx

@@ -32,6 +32,7 @@ import { AdminMenuDrawer } from '../admin-shell/chrome/menu-drawer.js'
 import { AdminMenuProvider } from '../admin-shell/chrome/menu-provider.js'
 import { RouteError, RouteNotFound } from '../admin-shell/chrome/route-error.js'
 import { bylineAdminServices } from '../integrations/byline-admin-services.js'
+import { BylineAiAdminProvider } from '../integrations/byline-ai.js'
 import { bylineFieldServices } from '../integrations/byline-field-services.js'
 import { getCurrentAdminUser } from '../server-fns/auth/index.js'
 
@@ -67,16 +68,18 @@ export function createAdminLayoutRoute(path: string, opts: AdminLayoutOpts = {})
       return (
         <BylineAdminServicesProvider services={bylineAdminServices}>
           <BylineFieldServicesProvider services={bylineFieldServices}>
-            <AdminMenuProvider>
-              <AdminAppBar user={user} />
-              <main className={cx('byline-admin-layout-main', layoutStyles.main)}>
-                <DrawerToggle />
-                <AdminMenuDrawer />
-                <Content>
-                  <Outlet />
-                </Content>
-              </main>
-            </AdminMenuProvider>
+            <BylineAiAdminProvider>
+              <AdminMenuProvider>
+                <AdminAppBar user={user} />
+                <main className={cx('byline-admin-layout-main', layoutStyles.main)}>
+                  <DrawerToggle />
+                  <AdminMenuDrawer />
+                  <Content>
+                    <Outlet />
+                  </Content>
+                </main>
+              </AdminMenuProvider>
+            </BylineAiAdminProvider>
           </BylineFieldServicesProvider>
         </BylineAdminServicesProvider>
       )

package/src/server-fns/ai/execute.ts

@@ -0,0 +1,79 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+/**
+ * Admin-only AI execute server function.
+ *
+ * Accepts an `ExecuteInstruction` payload, calls
+ * `executeInstruction` / `executeInstructionStreaming` from `@byline/ai`,
+ * and returns the result as a `Response` — JSON for non-streaming and
+ * NDJSON (`{ type: 'delta' | 'final' | 'error' }` lines) for streaming.
+ *
+ * Auth is enforced by `getAdminRequestContext()`, which throws
+ * `ERR_UNAUTHENTICATED` when no valid admin session is present.
+ */
+
+import { createServerFn } from '@tanstack/react-start'
+
+import type { ExecuteInstructionOptions, ExecuteInstructionParams } from '@byline/ai'
+// Server-only execute API — kept on the `/server` subpath so the browser
+// barrel for `@byline/ai` stays free of pino + the provider SDKs.
+import { executeInstruction, executeInstructionStreaming } from '@byline/ai/server'
+
+import { getAdminRequestContext } from '../../auth/auth-context.js'
+
+/**
+ * Wire shape — the same as `ExecuteInstruction` minus the in-process-only
+ * `signal` (an AbortSignal can't be serialized across the RPC boundary;
+ * the client passes its signal separately as a fetcher option).
+ */
+type ExecuteAiInstructionInput = {
+  params: ExecuteInstructionParams
+  options?: Omit<ExecuteInstructionOptions, 'signal'>
+}
+
+export const executeAiInstruction = createServerFn({ method: 'POST' })
+  .inputValidator((input: ExecuteAiInstructionInput) => input)
+  .handler(async ({ data }): Promise<Response> => {
+    // Throws ERR_UNAUTHENTICATED if there is no admin session.
+    await getAdminRequestContext()
+
+    if (data.options?.streaming) {
+      const streamResult = executeInstructionStreaming(data.params, data.options)
+      const ndjson = new ReadableStream<Uint8Array>({
+        async start(controller) {
+          const encoder = new TextEncoder()
+          const enqueue = (obj: unknown) => {
+            controller.enqueue(encoder.encode(`${JSON.stringify(obj)}\n`))
+          }
+          try {
+            for await (const chunk of streamResult.text) {
+              enqueue({ type: 'delta', text: chunk })
+            }
+            const finalState = await streamResult.final
+            enqueue({ type: 'final', state: finalState })
+          } catch (err) {
+            enqueue({
+              type: 'error',
+              message: err instanceof Error ? err.message : 'AI stream error',
+            })
+          } finally {
+            controller.close()
+          }
+        },
+      })
+      return new Response(ndjson, {
+        headers: { 'Content-Type': 'application/x-ndjson; charset=utf-8' },
+      })
+    }
+
+    const state = await executeInstruction(data.params, data.options)
+    return new Response(JSON.stringify(state), {
+      headers: { 'Content-Type': 'application/json; charset=utf-8' },
+    })
+  })

package/src/server-fns/ai/index.ts

@@ -0,0 +1,17 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+/**
+ * Admin-only AI server functions backing the `@byline/ai` plugins.
+ *
+ * The plugins use a `fetch`-shaped API; the host adapter ships a
+ * `aiFetchAdapter` in `@byline/host-tanstack-start/integrations/byline-ai`
+ * that wraps `executeAiInstruction` so the plugins remain transport-agnostic.
+ */
+
+export { executeAiInstruction } from './execute'