npm - @codemation/next-host - Versions diffs - 0.0.1 - Mend

@codemation/next-host 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (206) hide show

package/app/invite/[token]/page.tsx ADDED Viewed

@@ -0,0 +1,10 @@
+import { InviteAcceptScreen } from "../../../src/features/invite/screens/InviteAcceptScreen";
+export default async function InviteTokenPage(args: Readonly<{ params: Promise<{ token: string }> }>) {
+  const params = await args.params;
+  return (
+    <div className="min-h-0 flex-1 bg-background">
+      <InviteAcceptScreen inviteToken={params.token} />
+    </div>
+  );
+}

package/app/layout.tsx ADDED Viewed

@@ -0,0 +1,65 @@
+import "@xyflow/react/dist/style.css";
+import { League_Spartan } from "next/font/google";
+import "rc-tree/assets/index.css";
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+import { auth } from "../src/auth/codemationNextAuth";
+import { WhitelabelProvider } from "../src/providers/WhitelabelProvider";
+import { CodemationNextHost } from "../src/server/CodemationNextHost";
+import { CodemationNextClientShell } from "../src/shell/CodemationNextClientShell";
+import { CodemationSessionRoot } from "../src/providers/CodemationSessionProvider";
+import type { CodemationWhitelabelSnapshot } from "../src/whitelabel/CodemationWhitelabelSnapshot";
+import "./globals.css";
+/** Consumer whitelabel and auth must be evaluated per request; do not statically cache the root shell. */
+export const dynamic = "force-dynamic";
+const leagueSpartan = League_Spartan({
+  subsets: ["latin"],
+  display: "swap",
+  variable: "--font-league-spartan",
+});
+const defaultWhitelabel: CodemationWhitelabelSnapshot = {
+  productName: "Codemation",
+  logoUrl: null,
+};
+export async function generateMetadata(): Promise<Metadata> {
+  try {
+    const whitelabel = await CodemationNextHost.shared.getWhitelabelSnapshot();
+    return {
+      title: whitelabel.productName,
+      description: "Framework-managed workflows running inside the Next.js host.",
+    };
+  } catch {
+    return {
+      title: defaultWhitelabel.productName,
+      description: "Framework-managed workflows running inside the Next.js host.",
+    };
+  }
+}
+export default async function RootLayout(args: Readonly<{ children: ReactNode }>) {
+  const skipUiAuth = process.env.CODEMATION_SKIP_UI_AUTH === "true";
+  const session = skipUiAuth ? null : await auth();
+  let whitelabel: CodemationWhitelabelSnapshot;
+  try {
+    whitelabel = await CodemationNextHost.shared.getWhitelabelSnapshot();
+  } catch {
+    whitelabel = defaultWhitelabel;
+  }
+  return (
+    <html lang="en" className={leagueSpartan.variable} suppressHydrationWarning>
+      <body className={leagueSpartan.className} suppressHydrationWarning>
+        <WhitelabelProvider value={whitelabel}>
+          <CodemationNextClientShell>
+            <CodemationSessionRoot enabled={!skipUiAuth} session={session}>
+              {args.children}
+            </CodemationSessionRoot>
+          </CodemationNextClientShell>
+        </WhitelabelProvider>
+      </body>
+    </html>
+  );
+}

package/app/login/layout.tsx ADDED Viewed

@@ -0,0 +1,25 @@
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+import { CodemationNextHost } from "../../src/server/CodemationNextHost";
+export async function generateMetadata(): Promise<Metadata> {
+  try {
+    const whitelabel = await CodemationNextHost.shared.getWhitelabelSnapshot();
+    return {
+      title: `Sign in — ${whitelabel.productName}`,
+    };
+  } catch {
+    return {
+      title: "Sign in — Codemation",
+    };
+  }
+}
+export default function LoginLayout(args: Readonly<{ children: ReactNode }>) {
+  return (
+    <div className="codemation-login-root" data-testid="login-layout-root">
+      {args.children}
+    </div>
+  );
+}

package/app/login/page.tsx ADDED Viewed

@@ -0,0 +1,22 @@
+import { CodemationNextAuthOAuthProviderSnapshotResolver } from "../../src/auth/CodemationNextAuthOAuthProviderSnapshotResolver";
+import { CodemationNextHost } from "../../src/server/CodemationNextHost";
+import { LoginPageClient } from "../../src/shell/LoginPageClient";
+export default async function LoginPage(args: Readonly<{ searchParams: Promise<{ callbackUrl?: string }> }>) {
+  const searchParams = await args.searchParams;
+  const callbackUrl =
+    typeof searchParams.callbackUrl === "string" && searchParams.callbackUrl.length > 0
+      ? searchParams.callbackUrl
+      : "/";
+  const fallbackWhitelabel = { productName: "Codemation", logoUrl: null } as const;
+  const whitelabel = await CodemationNextHost.shared.getWhitelabelSnapshot().catch(() => fallbackWhitelabel);
+  const oauthProviders = await new CodemationNextAuthOAuthProviderSnapshotResolver().resolve().catch(() => []);
+  return (
+    <LoginPageClient
+      callbackUrl={callbackUrl}
+      productName={whitelabel.productName}
+      logoUrl={whitelabel.logoUrl}
+      oauthProviders={oauthProviders}
+    />
+  );
+}

package/components.json ADDED Viewed

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "radix-nova",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

package/docs/FORMS.md ADDED Viewed

@@ -0,0 +1,46 @@
+# Forms (next-host)
+## Stack
+- **React Hook Form** — performant, accessible field registration and submission.
+- **Zod** (v3 in this package) — schema validation at the boundary; infer TypeScript types from schemas. Kept on **Zod 3** for stable `@hookform/resolvers/zod` typings.
+- **`@hookform/resolvers/zod`** — connect Zod to RHF via `zodResolver`.
+- **UI** — `Form`, `FormField`, `FormItem`, `FormLabel`, `FormControl`, `FormDescription`, `FormMessage` from `@/components/ui/form`, wrapping `@/components/ui/input`, `Label`, etc.
+## Pattern
+1. Define a Zod schema (co-locate under the feature or a small `*Schema.ts` module).
+2. `useForm` with `resolver: zodResolver(schema)` and `defaultValues`.
+3. Wrap the form in `<Form {...form}>` (alias of `FormProvider`).
+4. For each field, use `FormField` + `FormItem` + `FormLabel` + `FormControl` + your `Input` / `Select` / `Textarea`.
+5. Surface field errors with `FormMessage`; optional help with `FormDescription`.
+6. Submit with `form.handleSubmit(onValid)`.
+## Imports
+Prefer the barrel so agents don’t mix ad-hoc stacks:
+```ts
+import {
+  z,
+  zodResolver,
+  useForm,
+  Form,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormControl,
+  FormMessage,
+} from "@/components/forms";
+import { Input } from "@/components/ui/input";
+```
+## ESLint
+`packages/next-host/eslint.config.mjs` forbids raw `<input>` and `<textarea>` outside `src/components/ui/**` (primitives live there). Use `Input` / `Textarea` + the form components above.
+## References
+- [React Hook Form](https://react-hook-form.com/)
+- [Zod](https://zod.dev/)
+- [shadcn/ui Form](https://ui.shadcn.com/docs/components/form)

package/docs/TAILWIND_SHADCN_MIGRATION.md ADDED Viewed

@@ -0,0 +1,89 @@
+# Tailwind v4 + shadcn/ui migration (next-host)
+## Goal
+Replace ad-hoc global CSS with **Tailwind CSS v4**, **design tokens** (CSS variables + `@theme inline`), and **shadcn/ui** primitives (Radix + copy-paste components). Prepare for **dashboards** later (Recharts + TanStack Table + shadcn chart patterns).
+## Inventory (refactor surface)
+| Area                                                                          | Notes                                                                                                                                                                                                                                                                        |
+| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`app/globals.css`**                                                         | ~1.5k lines after bootstrap: Tailwind imports + shadcn theme + **legacy** BEM-style rules (to delete incrementally).                                                                                                                                                         |
+| **`app/`**                                                                    | `layout.tsx`, `(shell)/layout.tsx`, `login/layout.tsx`, route `page.tsx` files — shell chrome and page wrappers.                                                                                                                                                             |
+| **`src/shell/`**                                                              | App layout, sidebar, header, login client — high-value for first Tailwind passes.                                                                                                                                                                                            |
+| **`src/features/credentials/`** (`screens/`, `components/`, `hooks/`, `lib/`) | Tables, dialogs, forms — migrate to `Button`, `Input`, `Dialog`, etc.                                                                                                                                                                                                        |
+| **`src/features/users/`**, **`invite/`**                                      | Same layout (`screens/` + `components/` where needed).                                                                                                                                                                                                                       |
+| **`src/features/workflows/`**                                                 | Largest surface: `screens/`, `components/{workflowDetail,canvas,realtime}/`, `hooks/`, `lib/{workflowDetail,realtime}/` — canvas helpers live under **`components/canvas/lib/`** (layout, edge resolvers, embedded styles). Many **inline `style={{}}`** (~200+ in package). |
+| **CSS-in-TS**                                                                 | `components/canvas/lib/workflowCanvasEmbeddedStyles.ts`, `lib/workflowDetailTreeStyles.ts` — keep minimal (keyframes, third-party overrides); rest → utilities/tokens.                                                                                                       |
+| **Vendor CSS**                                                                | `@xyflow/react/dist/style.css`, `rc-tree/assets/index.css` — keep; override with scoped classes or tokens.                                                                                                                                                                   |
+| **`src/components/`**                                                         | Shared widgets (`CodemationDataTable`, etc.) — adopt primitives + `cn()`.                                                                                                                                                                                                    |
+**Approximate counts (pre-migration):** ~230 `className=` in `.tsx`; ~238 `style={{` in `.tsx` (workflows-heavy).
+## What’s done (bootstrap)
+- **Tailwind v4** via `@tailwindcss/postcss` + `postcss.config.mjs`.
+- **`shadcn` CLI package** + **`tw-animate-css`**, **`class-variance-authority`**, **`clsx`**, **`tailwind-merge`**.
+- **`radix-ui`** (unified Radix primitives; required by **radix-nova** generated components such as `Button`).
+- **`components.json`** (`style: radix-nova`, `css: app/globals.css`, Lucide).
+- **`src/lib/utils.ts`** — `cn()` helper for class merging.
+- **`tsconfig`**: `baseUrl: "."`, `@/*` → `./src/*`, workspace aliases as **paths relative to `packages/next-host`** (required for Next + `@codemation/*` resolution).
+- **`app/globals.css`**: `@import "tailwindcss"`, `tw-animate-css`, `shadcn/tailwind.css`; `@theme inline`; shadcn `:root` / `.dark`; `@layer base`; **legacy bridge** (`--color-*`, `--sidebar-*`, spacing, buttons) → tokens; **legacy class rules** retained until screens migrate.
+## Phased rollout
+1. **Primitives** — `pnpm dlx shadcn@latest add button input label dialog select tabs table ...` into `src/components/ui/`. Use `@/components/ui/*` imports.
+2. **Shell** — Replace `.app-*` classes in `AppLayout` / nav with Tailwind + tokens; shrink `globals.css` sections.
+3. **Feature screens** — Credentials → Users → Invite → Workflows list → Workflow detail (inspector before canvas if easier).
+4. **Canvas** — Last: XYFlow needs pixel layout; prefer tokens + minimal inline where unavoidable.
+5. **Dashboards (later)** — Add **Recharts** + shadcn chart recipe; **TanStack Table** for dense grids; optional **Tremor** blocks only if needed.
+## Dark mode
+- Tokens already include `.dark` in `globals.css`. Add a **theme toggle** that sets `class="dark"` on `document.documentElement` (or `next-themes` when you add it).
+## ESLint / consistency
+- Keep **no Server Actions** rule in `packages/next-host`.
+- Root config enables **`no-alert`** (blocks `alert()`, `confirm()`, `prompt()` — use in-app UI). In **next-host** we extend the same idea for markup: **`no-restricted-syntax`** flags native **`<select>`** so agents use **`@/components/ui/select`** (Radix) instead of inconsistent browser styling and `change`-event tests.
+- Prefer **semantic utilities** (`bg-background`, `text-muted-foreground`) over raw palette classes in new code.
+- Optionally add **lint for raw `gray-*`** in a follow-up (team decision).
+## Buttons vs badges
+- **`Button`** (`src/components/ui/button.tsx`): **squarer corners** (`rounded-md`, smaller sizes `rounded-sm`), light **`shadow-sm`** on filled variants — reads as an actionable control.
+- **`Badge`** (`src/components/ui/badge.tsx`): **pill** shape (`rounded-full`), **`shadow-none`** — reads as status/metadata, not a primary action.
+## Composed dialogs (`CodemationDialog`)
+Use [`src/components/CodemationDialog.tsx`](src/components/CodemationDialog.tsx) for modal shells instead of hand-rolled `fixed inset-0` overlays. It wraps Radix **`Dialog`** + **`DialogContent`** (focus trap, escape, overlay) with a consistent layout:
+```tsx
+<CodemationDialog onClose={...} testId="..." size="wide" role="dialog">
+  <CodemationDialog.Title>Title</CodemationDialog.Title>
+  <CodemationDialog.Content>{/* scrollable body */}</CodemationDialog.Content>
+  <CodemationDialog.Actions position="bottom">{/* buttons */}</CodemationDialog.Actions>
+</CodemationDialog>
+```
+- **`CodemationDialog.Actions`** — `position="top" | "bottom"` (default `bottom`), `align="start" | "end" | "between"`.
+- **`size`** — `narrow` (~`lg`), `wide` (~`2xl`), `full`.
+- **Do not pass `id` to `CodemationDialog.Title`** — Radix assigns `titleId` in context; overriding `id` on `DialogTitle` breaks `aria-labelledby` and triggers dev warnings.
+- Optional **`role="alertdialog"`** for confirmations (e.g. delete confirm).
+## Verification (avoid heavy full-repo gates)
+Iterating on UI only:
+1. `pnpm --filter @codemation/next-host run lint`
+2. `pnpm run test:ui` (from repo root; host UI tests import next-host with `@/` alias)
+Use **`pnpm --filter @codemation/next-host run build`** when you need a Next production compile without building all workspace packages.
+Reserve **root `pnpm test`** / **`pnpm check`** / wide **`turbo run build`** for **CI or pre-merge** — they rebuild many packages and run all suites (high CPU/time).
+## References
+- [Tailwind + Next.js](https://tailwindcss.com/docs/installation/framework-guides/nextjs)
+- [shadcn manual install](https://ui.shadcn.com/docs/installation/manual)
+- [Tailwind v4 + shadcn](https://ui.shadcn.com/docs/tailwind-v4)

package/eslint.config.mjs ADDED Viewed

@@ -0,0 +1,56 @@
+import base from "@codemation/eslint-config";
+/** @type {import("eslint").Linter.FlatConfig[]} */
+export default [
+  ...base,
+  {
+    files: ["src/components/ui/**/*.tsx", "src/components/CodemationDialog.tsx"],
+    rules: {
+      "max-lines": "off",
+      "codemation/single-react-component-per-file": "off",
+    },
+  },
+  {
+    files: ["src/**/*.{ts,tsx}"],
+    ignores: ["src/api/CodemationApiClient.ts"],
+    rules: {
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector: "ExpressionStatement[expression.type='Literal'][expression.value='use server']",
+          message:
+            'Use the HTTP API (/api/*) and @codemation/host handlers only; do not add Server Actions ("use server").',
+        },
+        {
+          selector: "CallExpression[callee.type='Identifier'][callee.name='fetch']",
+          message:
+            "Use codemationApiClient from src/api/CodemationApiClient.ts for /api/* calls (same-origin session cookies, JSON, consistent errors). Global fetch() is reserved for that wrapper only.",
+        },
+      ],
+    },
+  },
+  {
+    files: ["src/**/*.{ts,tsx}"],
+    ignores: ["src/api/CodemationApiClient.ts", "src/components/ui/**"],
+    rules: {
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector: "JSXOpeningElement[name.name='select']",
+          message:
+            "Use @/components/ui/select (Radix/shadcn) instead of native <select> for consistent styling, keyboard behavior, and testability.",
+        },
+        {
+          selector: "JSXOpeningElement[name.name='input']",
+          message:
+            "Use @/components/ui/input with FormField/FormControl from @/components/ui/form (see packages/next-host/docs/FORMS.md) instead of raw <input>.",
+        },
+        {
+          selector: "JSXOpeningElement[name.name='textarea']",
+          message:
+            "Use @/components/ui/textarea with FormField/FormControl from @/components/ui/form (see packages/next-host/docs/FORMS.md) instead of raw <textarea>.",
+        },
+      ],
+    },
+  },
+];

package/middleware.ts ADDED Viewed

@@ -0,0 +1,29 @@
+import type { NextRequest } from "next/server";
+import { NextResponse } from "next/server";
+import { auth } from "./src/auth/codemationEdgeAuth";
+import { CodemationNextHostMiddlewarePathRules } from "./src/middleware/CodemationNextHostMiddlewarePathRules";
+export default auth((request: NextRequest) => {
+  if (process.env.CODEMATION_SKIP_UI_AUTH === "true") {
+    return NextResponse.next();
+  }
+  const pathname = request.nextUrl.pathname;
+  if (
+    CodemationNextHostMiddlewarePathRules.isFrameworkAuthRoute(pathname) ||
+    CodemationNextHostMiddlewarePathRules.isAnonymousApiRoute(pathname) ||
+    CodemationNextHostMiddlewarePathRules.isPublicUiRoute(pathname) ||
+    CodemationNextHostMiddlewarePathRules.isNextStaticAsset(pathname)
+  ) {
+    return NextResponse.next();
+  }
+  if (!request.auth) {
+    const loginUrl = new URL("/login", request.nextUrl.origin);
+    loginUrl.searchParams.set("callbackUrl", request.nextUrl.pathname + request.nextUrl.search);
+    return NextResponse.redirect(loginUrl);
+  }
+  return NextResponse.next();
+});
+export const config = {
+  matcher: ["/((?!_next/static|_next/image|.*\\.(?:ico|png|jpg|svg|webp)$).*)"],
+};

package/next-env.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/dev/types/routes.d.ts";
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/next.config.ts ADDED Viewed

@@ -0,0 +1,34 @@
+import type { NextConfig } from "next";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const nextHostDirectory = path.dirname(fileURLToPath(import.meta.url));
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+  /** Playwright and some browsers hit the dev server via 127.0.0.1 while Next prints localhost — silence Turbopack HMR cross-origin warnings. */
+  allowedDevOrigins: ["127.0.0.1", "localhost"],
+  serverExternalPackages: [
+    "@electric-sql/pglite",
+    "@electric-sql/pglite-socket",
+    "pglite-prisma-adapter",
+    "ws",
+    "bufferutil",
+    "utf-8-validate",
+  ],
+  transpilePackages: [
+    "@codemation/core",
+    "@codemation/core-nodes",
+    "@codemation/core-nodes-gmail",
+    "@codemation/eventbus-redis",
+    "@codemation/host",
+    "@codemation/node-example",
+    "@codemation/queue-bullmq",
+  ],
+  experimental: {
+    externalDir: true,
+  },
+  outputFileTracingRoot: path.resolve(nextHostDirectory, "../.."),
+};
+export default nextConfig;

package/package.json ADDED Viewed

@@ -0,0 +1,76 @@
+{
+  "name": "@codemation/next-host",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Made Relevant B.V.",
+  "homepage": "https://www.maderelevant.com",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@auth/prisma-adapter": "^2.11.1",
+    "@hookform/resolvers": "^5.2.2",
+    "@monaco-editor/react": "^4.7.0",
+    "@tanstack/react-query": "^5.90.21",
+    "@uiw/react-json-view": "2.0.0-alpha.41",
+    "@xyflow/react": "^12.10.1",
+    "bcryptjs": "^3.0.3",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "dagre": "^0.8.5",
+    "date-fns": "^4.1.0",
+    "hono": "^4.12.8",
+    "jose": "^6.2.2",
+    "lucide-react": "^0.577.0",
+    "monaco-editor": "^0.55.1",
+    "next": "^16.2.0",
+    "next-auth": "5.0.0-beta.30",
+    "pretty-ms": "^9.3.0",
+    "prisma": "^7.5.0",
+    "radix-ui": "^1.4.3",
+    "rc-tree": "^5.13.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-hook-form": "^7.71.2",
+    "shadcn": "^4.1.0",
+    "simple-icons": "^16.12.0",
+    "tailwind-merge": "^3.5.0",
+    "tw-animate-css": "^1.4.0",
+    "zod": "^3.25.76",
+    "zxcvbn": "^4.4.2",
+    "@codemation/core": "0.0.1",
+    "@codemation/host": "0.0.1"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/dagre": "^0.7.54",
+    "@types/node": "^25.3.5",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@types/zxcvbn": "^4.4.5",
+    "eslint": "^10.0.3",
+    "jsdom": "^25.0.1",
+    "postcss": "^8.5.8",
+    "tailwindcss": "^4.2.2",
+    "typescript": "^5.9.3",
+    "vitest": "4.0.18",
+    "@codemation/eslint-config": "0.0.0"
+  },
+  "scripts": {
+    "dev:next": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run"
+  }
+}

package/postcss.config.mjs ADDED Viewed

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+export default config;

package/public/canvas-icons/builtin/openai.svg ADDED Viewed

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 360 320" width="24" height="24" fill="#0f172a" aria-hidden="true">
+  <title>OpenAI</title>
+  <!-- Symbol only (wordmark omitted). Square canvas slot: use object-fit contain in the host. Source: Wikimedia OpenAI_Logo.svg (mark path). -->
+  <path d="m297.06 130.97c7.26-21.79 4.76-45.66-6.85-65.48-17.46-30.4-52.56-46.04-86.84-38.68-15.25-17.18-37.16-26.95-60.13-26.81-35.04-.08-66.13 22.48-76.91 55.82-22.51 4.61-41.94 18.7-53.31 38.67-17.59 30.32-13.58 68.54 9.92 94.54-7.26 21.79-4.76 45.66 6.85 65.48 17.46 30.4 52.56 46.04 86.84 38.68 15.24 17.18 37.16 26.95 60.13 26.8 35.06.09 66.16-22.49 76.94-55.86 22.51-4.61 41.94-18.7 53.31-38.67 17.57-30.32 13.55-68.51-9.94-94.51zm-120.28 168.11c-14.03.02-27.62-4.89-38.39-13.88.49-.26 1.34-.73 1.89-1.07l63.72-36.8c3.26-1.85 5.26-5.32 5.24-9.07v-89.83l26.93 15.55c.29.14.48.42.52.74v74.39c-.04 33.08-26.83 59.9-59.91 59.97zm-128.84-55.03c-7.03-12.14-9.56-26.37-7.15-40.18.47.28 1.3.79 1.89 1.13l63.72 36.8c3.23 1.89 7.23 1.89 10.47 0l77.79-44.92v31.1c.02.32-.13.63-.38.83l-64.41 37.19c-28.69 16.52-65.33 6.7-81.92-21.95zm-16.77-139.09c7-12.16 18.05-21.46 31.21-26.29 0 .55-.03 1.52-.03 2.2v73.61c-.02 3.74 1.98 7.21 5.23 9.06l77.79 44.91-26.93 15.55c-.27.18-.61.21-.91.08l-64.42-37.22c-28.63-16.58-38.45-53.21-21.95-81.89zm221.26 51.49-77.79-44.92 26.93-15.54c.27-.18.61-.21.91-.08l64.42 37.19c28.68 16.57 38.51 53.26 21.94 81.94-7.01 12.14-18.05 21.44-31.2 26.28v-75.81c.03-3.74-1.96-7.2-5.2-9.06zm26.8-40.34c-.47-.29-1.3-.79-1.89-1.13l-63.72-36.8c-3.23-1.89-7.23-1.89-10.47 0l-77.79 44.92v-31.1c-.02-.32.13-.63.38-.83l64.41-37.16c28.69-16.55 65.37-6.7 81.91 22 6.99 12.12 9.52 26.31 7.15 40.1zm-168.51 55.43-26.94-15.55c-.29-.14-.48-.42-.52-.74v-74.39c.02-33.12 26.89-59.96 60.01-59.94 14.01 0 27.57 4.92 38.34 13.88-.49.26-1.33.73-1.89 1.07l-63.72 36.8c-3.26 1.85-5.26 5.31-5.24 9.06l-.04 89.79zm14.63-31.54 34.65-20.01 34.65 20v40.01l-34.65 20-34.65-20z"/>
+</svg>

package/src/api/CodemationApiClient.ts ADDED Viewed

@@ -0,0 +1,107 @@
+import { CodemationApiHttpError } from "./CodemationApiHttpError";
+const defaultInit: Readonly<RequestInit> = {
+  cache: "no-store",
+  credentials: "same-origin",
+};
+function mergeHeaders(base: HeadersInit | undefined, extra: HeadersInit | undefined): Headers {
+  const headers = new Headers(base);
+  if (extra) {
+    const next = new Headers(extra);
+    next.forEach((value, key) => {
+      headers.set(key, value);
+    });
+  }
+  return headers;
+}
+/**
+ * Single place for browser calls to the Codemation App Router `/api/*` surface.
+ * Uses same-origin cookies (session) and consistent JSON + error handling.
+ */
+export class CodemationApiClient {
+  private async requestOrThrow(url: string, init: RequestInit): Promise<Response> {
+    const response = await fetch(url, { ...defaultInit, ...init });
+    if (!response.ok) {
+      const bodyText = typeof response.text === "function" ? await response.text() : "";
+      throw new CodemationApiHttpError(response.status, bodyText);
+    }
+    return response;
+  }
+  private async parseJsonBody<T>(response: Response): Promise<T> {
+    if (typeof response.json === "function") {
+      try {
+        const data = await response.json();
+        return data as T;
+      } catch {
+        // Empty or invalid JSON body — try text fallback when available.
+      }
+    }
+    if (typeof response.text === "function") {
+      const text = await response.text();
+      if (!text.trim()) {
+        return undefined as T;
+      }
+      return JSON.parse(text) as T;
+    }
+    return undefined as T;
+  }
+  async getJson<T>(url: string, init?: RequestInit): Promise<T> {
+    const response = await this.requestOrThrow(url, { method: "GET", ...init });
+    return this.parseJsonBody<T>(response);
+  }
+  async postJson<TResponse>(url: string, body?: unknown, init?: RequestInit): Promise<TResponse> {
+    const headers = mergeHeaders(init?.headers, { "content-type": "application/json" });
+    const response = await this.requestOrThrow(url, {
+      ...init,
+      method: "POST",
+      headers,
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    return this.parseJsonBody<TResponse>(response);
+  }
+  async putJson<TResponse>(url: string, body: unknown, init?: RequestInit): Promise<TResponse> {
+    const headers = mergeHeaders(init?.headers, { "content-type": "application/json" });
+    const response = await this.requestOrThrow(url, {
+      ...init,
+      method: "PUT",
+      headers,
+      body: JSON.stringify(body),
+    });
+    return this.parseJsonBody<TResponse>(response);
+  }
+  async patchJson<TResponse>(url: string, body: unknown, init?: RequestInit): Promise<TResponse> {
+    const headers = mergeHeaders(init?.headers, { "content-type": "application/json" });
+    const response = await this.requestOrThrow(url, {
+      ...init,
+      method: "PATCH",
+      headers,
+      body: JSON.stringify(body),
+    });
+    return this.parseJsonBody<TResponse>(response);
+  }
+  async delete(url: string, init?: RequestInit): Promise<void> {
+    await this.requestOrThrow(url, { method: "DELETE", ...init });
+  }
+  /** Multipart upload (browser sets Content-Type with boundary). */
+  async postFormData<T>(url: string, formData: FormData, init?: RequestInit): Promise<T> {
+    const response = await this.requestOrThrow(url, {
+      ...init,
+      method: "POST",
+      body: formData,
+      headers: init?.headers,
+    });
+    return this.parseJsonBody<T>(response);
+  }
+}
+/** Shared client for next-host UI modules (same-origin `/api/*`). */
+export const codemationApiClient = new CodemationApiClient();

package/src/api/CodemationApiHttpError.ts ADDED Viewed

@@ -0,0 +1,17 @@
+/**
+ * Thrown when a Codemation `/api/*` HTTP response has a non-OK status.
+ * Use {@link CodemationApiHttpError.bodyText} for user-facing or diagnostic messages.
+ */
+export class CodemationApiHttpError extends Error {
+  readonly status: number;
+  readonly bodyText: string;
+  constructor(status: number, bodyText: string) {
+    const trimmed = bodyText.trim();
+    super(trimmed.length > 0 ? `HTTP ${status}: ${trimmed}` : `HTTP ${status}`);
+    this.name = "CodemationApiHttpError";
+    this.status = status;
+    this.bodyText = bodyText;
+  }
+}

package/src/auth/CodemationNextAuthConfigResolver.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import type { CodemationAuthConfig } from "@codemation/host";
+export class CodemationNextAuthConfigResolver {
+  async resolve(): Promise<CodemationAuthConfig | undefined> {
+    const serialized = process.env.CODEMATION_AUTH_CONFIG_JSON;
+    if (serialized && serialized.trim().length > 0) {
+      const parsed = JSON.parse(serialized) as CodemationAuthConfig | null;
+      return parsed ?? undefined;
+    }
+    const { CodemationNextHost } = await import("../server/CodemationNextHost");
+    const context = await CodemationNextHost.shared.prepare();
+    return context.authConfig;
+  }
+}