canopycms-next 0.0.0

package/dist/adapter.d.ts

@@ -0,0 +1,50 @@
+import type { NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
+import { type CanopyHandlerOptions, type CanopyRequest } 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 declare function wrapNextRequest(req: NextRequest): CanopyRequest;
+/**
+ * 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 declare const createCanopyCatchAllHandler: (options: CanopyNextOptions) => (req: NextRequest, ctx?: {
+    params?: Promise<{
+        canopycms?: string[];
+        [key: string]: any;
+    }> | {
+        canopycms?: string[];
+        [key: string]: any;
+    };
+}) => Promise<NextResponse<unknown>>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAEnB,MAAM,gBAAgB,CAAA;AAEvB;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;CAAG;AAElE;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAkB/D;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,2BAA2B,GAAI,SAAS,iBAAiB,MAIlE,KAAK,WAAW,EAChB,MAAM;IACJ,MAAM,CAAC,EACH,OAAO,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC,GACrD;QAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAA;CACjD,mCAOJ,CAAA"}

package/dist/adapter.js

@@ -0,0 +1,80 @@
+import { NextResponse } from 'next/server';
+import { createCanopyRequestHandler, } from 'canopycms/http';
+/**
+ * Wrap a Next.js request to implement the CanopyRequest interface.
+ */
+export function wrapNextRequest(req) {
+    return {
+        method: req.method,
+        url: req.url,
+        header(name) {
+            return req.headers.get(name);
+        },
+        async json() {
+            if (req.method === 'GET')
+                return undefined;
+            try {
+                return await req.json();
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+/**
+ * Convert a CanopyResponse to a NextResponse.
+ */
+function toNextResponse(response) {
+    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) {
+    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) => {
+    const coreHandler = createCanopyRequestHandler(options);
+    return async (req, ctx) => {
+        const canopyReq = wrapNextRequest(req);
+        const segments = await extractPathSegments(ctx);
+        const response = await coreHandler(canopyReq, segments);
+        return toNextResponse(response);
+    };
+};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EACL,0BAA0B,GAI3B,MAAM,gBAAgB,CAAA;AAQvB;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC9C,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,EAAE,GAAG,CAAC,GAAG;QAEZ,MAAM,CAAC,IAAY;YACjB,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;QAED,KAAK,CAAC,IAAI;YACR,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK;gBAAE,OAAO,SAAS,CAAA;YAC1C,IAAI,CAAC;gBACH,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,QAAiC;IACvD,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;QACtC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,mBAAmB,CAAC,GAElC;IACC,IAAI,CAAC,GAAG,EAAE,MAAM;QAAE,OAAO,EAAE,CAAA;IAC3B,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA;IACpF,OAAO,CAAC,cAAc,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAC1D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,OAA0B,EAAE,EAAE;IACxE,MAAM,WAAW,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAA;IAEvD,OAAO,KAAK,EACV,GAAgB,EAChB,GAIC,EACD,EAAE;QACF,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAA;QAC/C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QACvD,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAA;IACjC,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+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 declare const NextCanopyEditorPage: (config: CanopyClientConfig) => () => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,kBAAkB,kDAW9D,CAAA"}

package/dist/client.js

@@ -0,0 +1,34 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useSearchParams } from 'next/navigation';
+import { CanopyEditorPage } 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) => {
+    const CorePage = CanopyEditorPage(config);
+    return function NextEditorPage() {
+        const urlSearchParams = useSearchParams();
+        const searchParams = {
+            branch: urlSearchParams.get('branch') ?? undefined,
+            entry: urlSearchParams.get('entry') ?? undefined,
+        };
+        return _jsx(CorePage, { searchParams: searchParams });
+    };
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGnD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAA0B,EAAE,EAAE;IACjE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAEzC,OAAO,SAAS,cAAc;QAC5B,MAAM,eAAe,GAAG,eAAe,EAAE,CAAA;QACzC,MAAM,YAAY,GAAG;YACnB,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS;YAClD,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS;SACjD,CAAA;QACD,OAAO,KAAC,QAAQ,IAAC,YAAY,EAAE,YAAY,GAAI,CAAA;IACjD,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/context-wrapper.d.ts

@@ -0,0 +1,26 @@
+import { type CanopyContext } from 'canopycms/server';
+import type { CanopyConfig, AuthPlugin, FieldConfig } from 'canopycms';
+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 declare function createNextCanopyContext(options: NextCanopyOptions): Promise<{
+    getCanopy: () => Promise<CanopyContext>;
+    handler: (req: import("next/server").NextRequest, ctx?: {
+        params?: Promise<{
+            canopycms?: string[];
+            [key: string]: any;
+        }> | {
+            canopycms?: string[];
+            [key: string]: any;
+        };
+    }) => Promise<import("next/server").NextResponse<unknown>>;
+    services: import("canopycms/server").CanopyServices;
+}>;
+//# sourceMappingURL=context-wrapper.d.ts.map

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

@@ -0,0 +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"}

package/dist/context-wrapper.js

@@ -0,0 +1,64 @@
+import { cache } from 'react';
+import { headers } from 'next/headers';
+import { createCanopyContext, createCanopyServices } from 'canopycms/server';
+import { authResultToCanopyUser } from 'canopycms';
+import { loadInternalGroups, loadBranchContext } from 'canopycms/server';
+import { createCanopyCatchAllHandler } from './adapter';
+let warnedNoAdmins = false;
+/**
+ * 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) {
+    // 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 () => {
+        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 = mainBranchContext
+            ? await loadInternalGroups(mainBranchContext.branchRoot, operatingMode, services.bootstrapAdminIds).catch((err) => {
+                console.warn('CanopyCMS: Failed to load internal groups from main branch:', err);
+                return [];
+            })
+            : [];
+        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(() => {
+        return coreContext.getContext();
+    });
+    // Create API handler using same services
+    const handler = createCanopyCatchAllHandler({
+        ...options,
+        services,
+    });
+    return {
+        getCanopy,
+        handler,
+        services,
+    };
+}
+//# sourceMappingURL=context-wrapper.js.map

package/dist/context-wrapper.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createCanopyCatchAllHandler, wrapNextRequest, type CanopyNextOptions } from './adapter';
+export { createNextCanopyContext, type NextCanopyOptions } from './context-wrapper';
+export { createMockAuthPlugin, createRejectingAuthPlugin } from './test-utils';
+//# 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":"AAAA,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAEhG,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAEnF,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createCanopyCatchAllHandler, wrapNextRequest } from './adapter';
+export { createNextCanopyContext } from './context-wrapper';
+export { createMockAuthPlugin, createRejectingAuthPlugin } from './test-utils';
+//# 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,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAA0B,MAAM,WAAW,CAAA;AAEhG,OAAO,EAAE,uBAAuB,EAA0B,MAAM,mBAAmB,CAAA;AAEnF,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA"}

package/dist/test-utils.d.ts

@@ -0,0 +1,12 @@
+import type { AuthPlugin } from 'canopycms/auth';
+import type { AuthenticatedUser } from 'canopycms';
+/**
+ * Create a mock AuthPlugin for testing.
+ * Returns a valid user by default (as Admin), or can be configured to return specific users.
+ */
+export declare const createMockAuthPlugin: (user?: AuthenticatedUser) => AuthPlugin;
+/**
+ * Create a mock AuthPlugin that rejects all authentication.
+ */
+export declare const createRejectingAuthPlugin: (error?: string) => AuthPlugin;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAIlD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAM,iBAIL,KACA,UAeD,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,cAAsB,KAAG,UAMjE,CAAA"}

package/dist/test-utils.js

@@ -0,0 +1,36 @@
+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 = {
+    type: 'authenticated',
+    userId: 'test-user',
+    groups: [ADMINS],
+}) => ({
+    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') => ({
+    authenticate: async () => ({ success: false, error }),
+    searchUsers: async () => [],
+    getUserMetadata: async () => null,
+    getGroupMetadata: async () => null,
+    listGroups: async () => [],
+});
+//# sourceMappingURL=test-utils.js.map

package/dist/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,GAAG,QAAQ,CAAA;AAEvB;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAA0B;IACxB,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,CAAC,MAAM,CAAC;CACjB,EACW,EAAE,CAAC,CAAC;IAChB,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACzB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE;YACJ,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,cAAc,EAAE,IAAI,CAAC,MAAM;SAC5B;KACF,CAAC;IACF,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;IAC3B,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;IACjC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;IAClC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;CAC3B,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAK,GAAG,cAAc,EAAc,EAAE,CAAC,CAAC;IAChF,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACrD,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;IAC3B,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;IACjC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;IAClC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;CAC3B,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "canopycms-next",
+  "version": "0.0.0",
+  "description": "Next.js adapter for CanopyCMS",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/safeinsights/canopycms.git",
+    "directory": "packages/canopycms-next"
+  },
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./client": "./src/client.tsx"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "exports": {
+      ".": {
+        "import": "./dist/index.js",
+        "types": "./dist/index.d.ts"
+      },
+      "./client": {
+        "import": "./dist/client.js",
+        "types": "./dist/client.d.ts"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run --reporter=dot",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "canopycms": "*",
+    "next": "^14.0.0 || ^15.0.0 || ^16.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "typescript": "^5.6.3",
+    "vitest": "^1.6.0"
+  }
+}

package/src/adapter.test.ts

@@ -0,0 +1,194 @@
+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

@@ -0,0 +1,105 @@
+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

@@ -0,0 +1,36 @@
+'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

@@ -0,0 +1,87 @@
+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

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1,42 @@
+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 () => [],
+})