canopycms-next 0.0.0 → 0.0.2

package/dist/context-wrapper.d.ts

@@ -2,13 +2,18 @@ import { type CanopyContext } from 'canopycms/server';
 import type { CanopyConfig, AuthPlugin, FieldConfig } from 'canopycms';
 export interface NextCanopyOptions {
     config: CanopyConfig;
-    authPlugin: AuthPlugin;
+    /** Auth plugin for user authentication. Optional for static deployments (deployedAs: 'static'). */
+    authPlugin?: AuthPlugin;
     entrySchemaRegistry: Record<string, readonly FieldConfig[]>;
 }
 /**
  * Create Next.js-specific wrapper around core context.
  * Adds React cache() for per-request memoization and API handler.
  * This function is async because it needs to load .collection.json meta files.
+ *
+ * In prod/prod-sim mode, if the provided authPlugin implements verifyTokenOnly(),
+ * it is automatically wrapped with CachingAuthPlugin + FileBasedAuthCache so that
+ * auth works without network access (Lambda). The cache is populated by the worker daemon.
  */
 export declare function createNextCanopyContext(options: NextCanopyOptions): Promise<{
     getCanopy: () => Promise<CanopyContext>;

package/dist/context-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-wrapper.d.ts","sourceRoot":"","sources":["../src/context-wrapper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,aAAa,EAAwB,MAAM,kBAAkB,CAAA;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAc,WAAW,EAAE,MAAM,WAAW,CAAA;AAQlF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAA;IACpB,UAAU,EAAE,UAAU,CAAA;IACtB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC,CAAA;CAC5D;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB;qBAiD1C,OAAO,CAAC,aAAa,CAAC;;cAJhD,CAAA;qBAGQ,CAAC;;;qBACE,CAAC;;;;;GAef"}
+{"version":3,"file":"context-wrapper.d.ts","sourceRoot":"","sources":["../src/context-wrapper.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAc,WAAW,EAAE,MAAM,WAAW,CAAA;AA+BlF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAA;IACpB,mGAAmG;IACnG,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC,CAAA;CAC5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB;qBAqF1C,OAAO,CAAC,aAAa,CAAC;;cAnEnC,CAAC;qBAA+B,CAAC;;;qBAC/B,CAAC;;;;;GAkFnB"}

package/dist/context-wrapper.js

@@ -1,16 +1,69 @@
+import path from 'node:path';
 import { cache } from 'react';
 import { headers } from 'next/headers';
-import { createCanopyContext, createCanopyServices } from 'canopycms/server';
+import { createCanopyContext, createCanopyServices, operatingStrategy, loadInternalGroups, loadBranchContext, } from 'canopycms/server';
 import { authResultToCanopyUser } from 'canopycms';
-import { loadInternalGroups, loadBranchContext } from 'canopycms/server';
+import { CachingAuthPlugin, FileBasedAuthCache } from 'canopycms/auth/cache';
 import { createCanopyCatchAllHandler } from './adapter';
 let warnedNoAdmins = false;
+let warnedStaticMode = false;
+/**
+ * Stub auth plugin for static deployments where no real auth is needed.
+ * Returns unauthenticated for all requests — API routes will return 401.
+ */
+const staticDeployAuthPlugin = {
+    async authenticate() {
+        return { success: false, error: 'No auth plugin configured (static deployment)' };
+    },
+    async searchUsers() {
+        return [];
+    },
+    async getUserMetadata() {
+        return null;
+    },
+    async getGroupMetadata() {
+        return null;
+    },
+    async listGroups() {
+        return [];
+    },
+};
 /**
  * Create Next.js-specific wrapper around core context.
  * Adds React cache() for per-request memoization and API handler.
  * This function is async because it needs to load .collection.json meta files.
+ *
+ * In prod/prod-sim mode, if the provided authPlugin implements verifyTokenOnly(),
+ * it is automatically wrapped with CachingAuthPlugin + FileBasedAuthCache so that
+ * auth works without network access (Lambda). The cache is populated by the worker daemon.
  */
 export async function createNextCanopyContext(options) {
+    // Fail fast: authPlugin is required for server deployments
+    if (options.config.deployedAs !== 'static' && !options.authPlugin) {
+        throw new Error('CanopyCMS: authPlugin is required when deployedAs is "server". ' +
+            'Set deployedAs: "static" in your canopy config, or provide an authPlugin.');
+    }
+    // Warn when running in static deployment mode so it is not accidentally set in a server build
+    if (options.config.deployedAs === 'static' && !warnedStaticMode) {
+        console.warn('CanopyCMS: running in static deployment mode — all CMS API requests will return 401. ' +
+            'Do not set deployedAs: "static" in a server deployment.');
+        warnedStaticMode = true;
+    }
+    // Resolve the auth plugin: auto-wrap with CachingAuthPlugin for prod/prod-sim when
+    // the plugin supports token-only verification. This keeps auth networkless (required for
+    // Lambda) without exposing caching internals to adopters.
+    // For static deployments, use the stub that returns 401 for all requests.
+    const { mode } = options.config;
+    const authPlugin = (() => {
+        if (!options.authPlugin)
+            return staticDeployAuthPlugin;
+        if ((mode === 'prod' || mode === 'prod-sim') && options.authPlugin.verifyTokenOnly) {
+            const cachePath = process.env.CANOPY_AUTH_CACHE_PATH ??
+                path.join(operatingStrategy(mode).getWorkspaceRoot(), '.cache');
+            return new CachingAuthPlugin((ctx) => options.authPlugin.verifyTokenOnly(ctx), new FileBasedAuthCache(cachePath));
+        }
+        return options.authPlugin;
+    })();
     // Create services ONCE at initialization
     const services = await createCanopyServices(options.config, {
         entrySchemaRegistry: options.entrySchemaRegistry,
@@ -18,7 +71,7 @@ export async function createNextCanopyContext(options) {
     // User extractor: passes Next.js headers to auth plugin, loads internal groups, applies authorization
     const extractUser = async () => {
         const headersList = await headers();
-        const authResult = await options.authPlugin.authenticate(headersList);
+        const authResult = await authPlugin.authenticate(headersList);
         // Load internal groups from main branch
         const baseBranch = services.config.defaultBaseBranch ?? 'main';
         const operatingMode = services.config.mode ?? 'dev';
@@ -53,6 +106,7 @@ export async function createNextCanopyContext(options) {
     // Create API handler using same services
     const handler = createCanopyCatchAllHandler({
         ...options,
+        authPlugin,
         services,
     });
     return {

package/dist/context-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-wrapper.js","sourceRoot":"","sources":["../src/context-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,mBAAmB,EAAsB,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAEhG,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAExE,OAAO,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAA;AAEvD,IAAI,cAAc,GAAG,KAAK,CAAA;AAQ1B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAA0B;IACtE,yCAAyC;IACzC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE;QAC1D,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;KACjD,CAAC,CAAA;IAEF,sGAAsG;IACtG,MAAM,WAAW,GAAG,KAAK,IAAyB,EAAE;QAClD,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAA;QACnC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,WAAW,CAAC,CAAA;QAErE,wCAAwC;QACxC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAA;QAC9D,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAA;QACnD,MAAM,iBAAiB,GAAG,MAAM,iBAAiB,CAAC;YAChD,UAAU,EAAE,UAAU;YACtB,IAAI,EAAE,aAAa;SACpB,CAAC,CAAA;QACF,MAAM,cAAc,GAAoB,iBAAiB;YACvD,CAAC,CAAC,MAAM,kBAAkB,CACtB,iBAAiB,CAAC,UAAU,EAC5B,aAAa,EACb,QAAQ,CAAC,iBAAiB,CAC3B,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACvB,OAAO,CAAC,IAAI,CAAC,6DAA6D,EAAE,GAAG,CAAC,CAAA;gBAChF,OAAO,EAAqB,CAAA;YAC9B,CAAC,CAAC;YACJ,CAAC,CAAC,EAAE,CAAA;QAEN,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YACrD,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;YACjE,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrD,OAAO,CAAC,IAAI,CACV,0GAA0G,CAC3G,CAAA;YACH,CAAC;YACD,cAAc,GAAG,IAAI,CAAA;QACvB,CAAC;QAED,OAAO,sBAAsB,CAAC,UAAU,EAAE,QAAQ,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAA;IACvF,CAAC,CAAA;IAED,qEAAqE;IACrE,MAAM,WAAW,GAAG,mBAAmB,CAAC;QACtC,QAAQ;QACR,WAAW;KACZ,CAAC,CAAA;IAEF,kDAAkD;IAClD,MAAM,SAAS,GAAG,KAAK,CAAC,GAA2B,EAAE;QACnD,OAAO,WAAW,CAAC,UAAU,EAAE,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,yCAAyC;IACzC,MAAM,OAAO,GAAG,2BAA2B,CAAC;QAC1C,GAAG,OAAO;QACV,QAAQ;KACT,CAAC,CAAA;IAEF,OAAO;QACL,SAAS;QACT,OAAO;QACP,QAAQ;KACT,CAAA;AACH,CAAC"}
+{"version":3,"file":"context-wrapper.js","sourceRoot":"","sources":["../src/context-wrapper.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "canopycms-next",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "description": "Next.js adapter for CanopyCMS",
   "license": "MIT",
   "repository": {
@@ -17,8 +17,7 @@
     "./client": "./src/client.tsx"
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "publishConfig": {
     "exports": {
@@ -41,8 +40,8 @@
     "node": ">=18"
   },
   "peerDependencies": {
-    "canopycms": "*",
-    "next": "^14.0.0 || ^15.0.0 || ^16.0.0",
+    "canopycms": "^0.0.2",
+    "next": "^0.0.2",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {

package/src/adapter.test.ts

@@ -1,194 +0,0 @@
-import { describe, expect, it, vi } from 'vitest'
-
-// Mock next/server before any imports
-vi.mock('next/server', () => {
-  return {
-    NextResponse: {
-      json: (body: any, init?: any) => ({
-        body,
-        status: init?.status ?? 200,
-        headers: init?.headers,
-      }),
-    },
-  }
-})
-
-// Mock canopycms/http to return a controlled response
-vi.mock('canopycms/http', async () => {
-  return {
-    createCanopyRequestHandler: vi.fn(() => {
-      return async (req: any, segments: string[]) => {
-        // Return different responses based on segments
-        if (segments.length === 1 && segments[0] === 'branches') {
-          return {
-            status: 200,
-            body: { ok: true, status: 200, data: { branches: [] } },
-          }
-        }
-        if (segments.length === 0 || segments.includes('unknown')) {
-          return {
-            status: 404,
-            body: { ok: false, status: 404, error: 'Not found' },
-          }
-        }
-        return {
-          status: 200,
-          body: { ok: true, status: 200 },
-        }
-      }
-    }),
-  }
-})
-
-import { createCanopyCatchAllHandler } from './adapter'
-import { createMockAuthPlugin } from './test-utils'
-
-describe('Next.js adapter', () => {
-  const mockAuthPlugin = createMockAuthPlugin({
-    userId: 'test-user',
-    groups: ['Admins'],
-  })
-
-  describe('createCanopyCatchAllHandler', () => {
-    it('converts NextRequest to CanopyRequest and returns NextResponse', async () => {
-      const handler = createCanopyCatchAllHandler({
-        services: {} as any,
-        authPlugin: mockAuthPlugin,
-      })
-
-      const mockNextRequest = {
-        method: 'GET',
-        url: 'http://localhost:3000/api/canopycms/branches',
-        headers: { get: () => null },
-        json: async () => undefined,
-      } as any
-
-      const response: any = await handler(mockNextRequest, {
-        params: { canopycms: ['branches'] },
-      })
-
-      expect(response.status).toBe(200)
-      expect(response.body).toHaveProperty('ok', true)
-    })
-
-    it('handles Next.js 14 direct params object', async () => {
-      const handler = createCanopyCatchAllHandler({
-        services: {} as any,
-        authPlugin: mockAuthPlugin,
-      })
-
-      const mockNextRequest = {
-        method: 'GET',
-        url: 'http://localhost:3000/api/canopycms/branches',
-        headers: { get: () => null },
-        json: async () => undefined,
-      } as any
-
-      // Next.js 14 style - params is a direct object
-      const response: any = await handler(mockNextRequest, {
-        params: { canopycms: ['branches'] },
-      })
-
-      expect(response.status).toBe(200)
-    })
-
-    it('handles Next.js 15 async params Promise', async () => {
-      const handler = createCanopyCatchAllHandler({
-        services: {} as any,
-        authPlugin: mockAuthPlugin,
-      })
-
-      const mockNextRequest = {
-        method: 'GET',
-        url: 'http://localhost:3000/api/canopycms/branches',
-        headers: { get: () => null },
-        json: async () => undefined,
-      } as any
-
-      // Next.js 15 style - params is a Promise
-      const response: any = await handler(mockNextRequest, {
-        params: Promise.resolve({ canopycms: ['branches'] }),
-      })
-
-      expect(response.status).toBe(200)
-    })
-
-    it('handles missing params gracefully', async () => {
-      const handler = createCanopyCatchAllHandler({
-        services: {} as any,
-        authPlugin: mockAuthPlugin,
-      })
-
-      const mockNextRequest = {
-        method: 'GET',
-        url: 'http://localhost:3000/api/canopycms',
-        headers: { get: () => null },
-        json: async () => undefined,
-      } as any
-
-      // No params at all
-      const response: any = await handler(mockNextRequest, undefined)
-
-      expect(response.status).toBe(404)
-    })
-  })
-})
-
-describe('wrapNextRequest', () => {
-  it('wraps NextRequest correctly', async () => {
-    const { wrapNextRequest } = await import('./adapter')
-
-    const mockReq = {
-      method: 'POST',
-      url: 'http://localhost:3000/api/canopycms/branches',
-      headers: {
-        get: (name: string) =>
-          name.toLowerCase() === 'authorization' ? 'Bearer test-token' : null,
-      },
-      json: async () => ({ name: 'test-branch' }),
-    } as any
-
-    const wrapped = wrapNextRequest(mockReq)
-
-    expect(wrapped.method).toBe('POST')
-    expect(wrapped.url).toBe('http://localhost:3000/api/canopycms/branches')
-    expect(wrapped.header('Authorization')).toBe('Bearer test-token')
-    expect(await wrapped.json()).toEqual({ name: 'test-branch' })
-  })
-
-  it('returns null for missing headers', async () => {
-    const { wrapNextRequest } = await import('./adapter')
-
-    const mockReq = {
-      method: 'GET',
-      url: 'http://localhost:3000/api/test',
-      headers: {
-        get: () => null,
-      },
-      json: async () => undefined,
-    } as any
-
-    const wrapped = wrapNextRequest(mockReq)
-
-    expect(wrapped.header('X-Custom-Header')).toBeNull()
-  })
-
-  it('returns undefined for GET request body', async () => {
-    const { wrapNextRequest } = await import('./adapter')
-
-    const mockReq = {
-      method: 'GET',
-      url: 'http://localhost:3000/api/test',
-      headers: {
-        get: () => null,
-      },
-      json: async () => {
-        throw new Error('No body')
-      },
-    } as any
-
-    const wrapped = wrapNextRequest(mockReq)
-
-    expect(await wrapped.json()).toBeUndefined()
-  })
-})

package/src/adapter.ts

@@ -1,105 +0,0 @@
-import type { NextRequest } from 'next/server'
-import { NextResponse } from 'next/server'
-
-import {
-  createCanopyRequestHandler,
-  type CanopyHandlerOptions,
-  type CanopyRequest,
-  type CanopyResponse,
-} from 'canopycms/http'
-
-/**
- * Options for creating a Canopy Next.js handler.
- * Same as core CanopyHandlerOptions - re-exported for convenience.
- */
-export interface CanopyNextOptions extends CanopyHandlerOptions {}
-
-/**
- * Wrap a Next.js request to implement the CanopyRequest interface.
- */
-export function wrapNextRequest(req: NextRequest): CanopyRequest {
-  return {
-    method: req.method,
-    url: req.url,
-
-    header(name: string): string | null {
-      return req.headers.get(name)
-    },
-
-    async json(): Promise<unknown> {
-      if (req.method === 'GET') return undefined
-      try {
-        return await req.json()
-      } catch {
-        return undefined
-      }
-    },
-  }
-}
-
-/**
- * Convert a CanopyResponse to a NextResponse.
- */
-function toNextResponse(response: CanopyResponse<unknown>): ReturnType<typeof NextResponse.json> {
-  return NextResponse.json(response.body, {
-    status: response.status,
-    headers: response.headers,
-  })
-}
-
-/**
- * Extract path segments from Next.js catch-all route params.
- * Handles both Next.js 14 (direct object) and Next.js 15 (Promise) params.
- */
-async function extractPathSegments(ctx?: {
-  params?: Promise<{ canopycms?: string[] }> | { canopycms?: string[] }
-}): Promise<string[]> {
-  if (!ctx?.params) return []
-  const resolvedParams = ctx.params instanceof Promise ? await ctx.params : ctx.params
-  return (resolvedParams?.canopycms ?? []).filter(Boolean)
-}
-
-/**
- * Catch-all Next.js handler for a single API route (e.g., /api/canopycms/[...canopycms]).
- *
- * This is a thin adapter that:
- * 1. Converts NextRequest to CanopyRequest
- * 2. Extracts path segments from Next.js params
- * 3. Delegates to the core handler
- * 4. Converts CanopyResponse to NextResponse
- *
- * @example
- * ```ts
- * // app/api/canopycms/[...canopycms]/route.ts
- * import { createCanopyCatchAllHandler } from 'canopycms-next'
- * import { createClerkAuthPlugin } from 'canopycms-auth-clerk'
- * import config from '../../../../canopycms.config'
- *
- * const handler = createCanopyCatchAllHandler({
- *   config: config.server,
- *   authPlugin: createClerkAuthPlugin({ useOrganizationsAsGroups: true }),
- * })
- *
- * export const GET = handler
- * export const POST = handler
- * export const PUT = handler
- * export const DELETE = handler
- * ```
- */
-export const createCanopyCatchAllHandler = (options: CanopyNextOptions) => {
-  const coreHandler = createCanopyRequestHandler(options)
-
-  return async (
-    req: NextRequest,
-    ctx?: {
-      params?:
-        | Promise<{ canopycms?: string[]; [key: string]: any }>
-        | { canopycms?: string[]; [key: string]: any }
-    },
-  ) => {
-    const canopyReq = wrapNextRequest(req)
-    const segments = await extractPathSegments(ctx)
-    const response = await coreHandler(canopyReq, segments)
-    return toNextResponse(response)
-  }
-}

package/src/client.tsx

@@ -1,36 +0,0 @@
-'use client'
-
-import { useSearchParams } from 'next/navigation'
-import { CanopyEditorPage } from 'canopycms/client'
-import type { CanopyClientConfig } from 'canopycms/client'
-
-/**
- * Next.js-specific wrapper for CanopyEditorPage that automatically reads
- * URL search params (branch, entry) using Next.js's useSearchParams hook.
- *
- * @example
- * ```tsx
- * // app/edit/page.tsx
- * 'use client'
- * import { NextCanopyEditorPage } from 'canopycms-next/client'
- * import config from '../../canopycms.config'
- *
- * export default function EditPage() {
- *   const clientConfig = config.client()
- *   const EditorPage = NextCanopyEditorPage(clientConfig)
- *   return <EditorPage />
- * }
- * ```
- */
-export const NextCanopyEditorPage = (config: CanopyClientConfig) => {
-  const CorePage = CanopyEditorPage(config)
-
-  return function NextEditorPage() {
-    const urlSearchParams = useSearchParams()
-    const searchParams = {
-      branch: urlSearchParams.get('branch') ?? undefined,
-      entry: urlSearchParams.get('entry') ?? undefined,
-    }
-    return <CorePage searchParams={searchParams} />
-  }
-}

package/src/context-wrapper.ts

@@ -1,87 +0,0 @@
-import { cache } from 'react'
-import { headers } from 'next/headers'
-import { createCanopyContext, type CanopyContext, createCanopyServices } from 'canopycms/server'
-import type { CanopyConfig, AuthPlugin, CanopyUser, FieldConfig } from 'canopycms'
-import { authResultToCanopyUser } from 'canopycms'
-import { loadInternalGroups, loadBranchContext } from 'canopycms/server'
-import type { InternalGroup } from 'canopycms/server'
-import { createCanopyCatchAllHandler } from './adapter'
-
-let warnedNoAdmins = false
-
-export interface NextCanopyOptions {
-  config: CanopyConfig
-  authPlugin: AuthPlugin
-  entrySchemaRegistry: Record<string, readonly FieldConfig[]>
-}
-
-/**
- * Create Next.js-specific wrapper around core context.
- * Adds React cache() for per-request memoization and API handler.
- * This function is async because it needs to load .collection.json meta files.
- */
-export async function createNextCanopyContext(options: NextCanopyOptions) {
-  // Create services ONCE at initialization
-  const services = await createCanopyServices(options.config, {
-    entrySchemaRegistry: options.entrySchemaRegistry,
-  })
-
-  // User extractor: passes Next.js headers to auth plugin, loads internal groups, applies authorization
-  const extractUser = async (): Promise<CanopyUser> => {
-    const headersList = await headers()
-    const authResult = await options.authPlugin.authenticate(headersList)
-
-    // Load internal groups from main branch
-    const baseBranch = services.config.defaultBaseBranch ?? 'main'
-    const operatingMode = services.config.mode ?? 'dev'
-    const mainBranchContext = await loadBranchContext({
-      branchName: baseBranch,
-      mode: operatingMode,
-    })
-    const internalGroups: InternalGroup[] = mainBranchContext
-      ? await loadInternalGroups(
-          mainBranchContext.branchRoot,
-          operatingMode,
-          services.bootstrapAdminIds,
-        ).catch((err: unknown) => {
-          console.warn('CanopyCMS: Failed to load internal groups from main branch:', err)
-          return [] as InternalGroup[]
-        })
-      : []
-
-    if (!warnedNoAdmins && Array.isArray(internalGroups)) {
-      const adminsGroup = internalGroups.find((g) => g.id === 'Admins')
-      if (!adminsGroup || adminsGroup.members.length === 0) {
-        console.warn(
-          'CanopyCMS: No admin users configured. Set CANOPY_BOOTSTRAP_ADMIN_IDS or add members to the Admins group.',
-        )
-      }
-      warnedNoAdmins = true
-    }
-
-    return authResultToCanopyUser(authResult, services.bootstrapAdminIds, internalGroups)
-  }
-
-  // Create core context with pre-created services (framework-agnostic)
-  const coreContext = createCanopyContext({
-    services,
-    extractUser,
-  })
-
-  // Wrap with React cache() for per-request caching
-  const getCanopy = cache((): Promise<CanopyContext> => {
-    return coreContext.getContext()
-  })
-
-  // Create API handler using same services
-  const handler = createCanopyCatchAllHandler({
-    ...options,
-    services,
-  })
-
-  return {
-    getCanopy,
-    handler,
-    services,
-  }
-}

package/src/index.ts

@@ -1,5 +0,0 @@
-export { createCanopyCatchAllHandler, wrapNextRequest, type CanopyNextOptions } from './adapter'
-
-export { createNextCanopyContext, type NextCanopyOptions } from './context-wrapper'
-
-export { createMockAuthPlugin, createRejectingAuthPlugin } from './test-utils'

package/src/test-utils.ts

@@ -1,42 +0,0 @@
-import type { AuthPlugin } from 'canopycms/auth'
-import type { AuthenticatedUser } from 'canopycms'
-
-const ADMINS = 'Admins'
-
-/**
- * Create a mock AuthPlugin for testing.
- * Returns a valid user by default (as Admin), or can be configured to return specific users.
- */
-export const createMockAuthPlugin = (
-  user: AuthenticatedUser = {
-    type: 'authenticated',
-    userId: 'test-user',
-    groups: [ADMINS],
-  },
-): AuthPlugin => ({
-  authenticate: async () => ({
-    success: true,
-    user: {
-      userId: user.userId,
-      email: user.email,
-      name: user.name,
-      avatarUrl: user.avatarUrl,
-      externalGroups: user.groups,
-    },
-  }),
-  searchUsers: async () => [],
-  getUserMetadata: async () => null,
-  getGroupMetadata: async () => null,
-  listGroups: async () => [],
-})
-
-/**
- * Create a mock AuthPlugin that rejects all authentication.
- */
-export const createRejectingAuthPlugin = (error = 'Unauthorized'): AuthPlugin => ({
-  authenticate: async () => ({ success: false, error }),
-  searchUsers: async () => [],
-  getUserMetadata: async () => null,
-  getGroupMetadata: async () => null,
-  listGroups: async () => [],
-})