@agntcms/next 0.2.1 → 0.3.0

package/dist/config.cjs

@@ -80,10 +80,17 @@ function defineConfig(config) {
 }
 
 // src/config/withagntcms.ts
+var DEV_PAGE_EXTENSIONS = ["dev.ts", "dev.tsx", "ts", "tsx", "js", "jsx"];
+var PROD_PAGE_EXTENSIONS = ["ts", "tsx", "js", "jsx"];
 function withagntcms(nextConfig) {
+  const isProd = process.env.NODE_ENV === "production";
+  const defaultPageExtensions = isProd ? PROD_PAGE_EXTENSIONS : DEV_PAGE_EXTENSIONS;
+  const userPageExtensions = nextConfig.pageExtensions;
+  const pageExtensions = Array.isArray(userPageExtensions) ? userPageExtensions : [...defaultPageExtensions];
   return {
     ...nextConfig,
-    output: "standalone"
+    output: "standalone",
+    pageExtensions
   };
 }
 

package/dist/config.d.cts

@@ -102,11 +102,18 @@ declare function defineConfig(config: AgentCmsConfig): ResolvedConfig;
  * Sets `output: 'standalone'` so the production Docker build
  * (which copies `.next/standalone/`) works out of the box.
  *
+ * Also injects a `pageExtensions` default: in dev we accept `.dev.ts` /
+ * `.dev.tsx` so dev-only routes (preview, admin, MCP) can be named
+ * `route.dev.ts` and excluded from the production build automatically.
+ * If the user already provided `pageExtensions`, theirs wins — the
+ * convention is opt-in.
+ *
  * In future versions this may also configure webpack aliases,
  * image optimization domains, or framework-level middleware.
  */
 declare function withagntcms<T extends Record<string, unknown>>(nextConfig: T): T & {
     output: 'standalone';
+    pageExtensions: string[];
 };
 
 export { type AgentCmsConfig, AnyFormDefinition, type PageTemplate, type ResolvedConfig, type SubmissionRateLimit, SubmissionStorageAdapter, defineConfig, withagntcms };

package/dist/config.d.ts

@@ -102,11 +102,18 @@ declare function defineConfig(config: AgentCmsConfig): ResolvedConfig;
  * Sets `output: 'standalone'` so the production Docker build
  * (which copies `.next/standalone/`) works out of the box.
  *
+ * Also injects a `pageExtensions` default: in dev we accept `.dev.ts` /
+ * `.dev.tsx` so dev-only routes (preview, admin, MCP) can be named
+ * `route.dev.ts` and excluded from the production build automatically.
+ * If the user already provided `pageExtensions`, theirs wins — the
+ * convention is opt-in.
+ *
  * In future versions this may also configure webpack aliases,
  * image optimization domains, or framework-level middleware.
  */
 declare function withagntcms<T extends Record<string, unknown>>(nextConfig: T): T & {
     output: 'standalone';
+    pageExtensions: string[];
 };
 
 export { type AgentCmsConfig, AnyFormDefinition, type PageTemplate, type ResolvedConfig, type SubmissionRateLimit, SubmissionStorageAdapter, defineConfig, withagntcms };

package/dist/config.mjs

@@ -35,10 +35,17 @@ function defineConfig(config) {
 }
 
 // src/config/withagntcms.ts
+var DEV_PAGE_EXTENSIONS = ["dev.ts", "dev.tsx", "ts", "tsx", "js", "jsx"];
+var PROD_PAGE_EXTENSIONS = ["ts", "tsx", "js", "jsx"];
 function withagntcms(nextConfig) {
+  const isProd = process.env.NODE_ENV === "production";
+  const defaultPageExtensions = isProd ? PROD_PAGE_EXTENSIONS : DEV_PAGE_EXTENSIONS;
+  const userPageExtensions = nextConfig.pageExtensions;
+  const pageExtensions = Array.isArray(userPageExtensions) ? userPageExtensions : [...defaultPageExtensions];
   return {
     ...nextConfig,
-    output: "standalone"
+    output: "standalone",
+    pageExtensions
   };
 }
 

package/dist/handlers.cjs

@@ -45,7 +45,8 @@ __export(handlers_exports, {
   createPreviewTokenStore: () => createPreviewTokenStore,
   createSubmitFormHandler: () => createSubmitFormHandler,
   createTaskStore: () => createTaskStore,
-  createTemplateHandler: () => createTemplateHandler
+  createTemplateHandler: () => createTemplateHandler,
+  createagntcmsRouteHandler: () => createagntcmsRouteHandler
 });
 module.exports = __toCommonJS(handlers_exports);
 
@@ -2502,6 +2503,84 @@ function createFormsDeleteHandler() {
   };
 }
 
+// src/handlers/dispatcher.ts
+function buildRouteTable(h) {
+  const table = /* @__PURE__ */ new Map();
+  table.set("assets", { GET: h.assets.list });
+  table.set("assets/upload", { POST: h.assets.upload });
+  table.set("events", { GET: async (req) => h.events.GET(req) });
+  table.set("mcp", { POST: h.mcp.POST });
+  table.set("draft/save", { POST: h.draft.save });
+  table.set("draft/list", { GET: h.draft.list });
+  table.set("draft/publish", { POST: h.draft.publish });
+  table.set("draft/reorder", { POST: h.draft.reorder });
+  table.set("draft/discard", { POST: h.draft.discard });
+  table.set("page/list", { GET: h.page.list });
+  table.set("page/read", { GET: h.page.read });
+  table.set("page/delete", { POST: h.page.deletePage });
+  table.set("page/unpublish", { POST: h.page.unpublish });
+  table.set("page/history", { GET: h.page.listHistory });
+  table.set("page/rollback", { POST: h.page.rollback });
+  table.set("page/rename", { POST: h.page.rename });
+  table.set("page/duplicate", { POST: h.page.duplicate });
+  table.set("global/list", { GET: h.global.list });
+  table.set("global/read", { GET: h.global.read });
+  table.set("global/save", { POST: h.global.save });
+  table.set("global/delete", { DELETE: h.global.delete });
+  table.set("global/history", { GET: h.global.listHistory });
+  table.set("global/rollback", { POST: h.global.rollback });
+  table.set("preview/enter", { POST: async (req) => h.preview.enter(req), GET: async (req) => h.preview.enterWithToken(req) });
+  table.set("preview/exit", { POST: async (req) => h.preview.exit(req) });
+  table.set("preview/issue", { POST: h.preview.issueToken });
+  table.set("template/list", { GET: h.template.list });
+  table.set("forms/list", { GET: h.formsList });
+  table.set("forms/read", { GET: h.formsRead });
+  table.set("forms/delete", { POST: h.formsDelete });
+  return table;
+}
+function createagntcmsRouteHandler(opts) {
+  const handlers = {
+    assets: createAssetsHandler(opts.assets),
+    draft: createDraftHandler(opts.draft),
+    page: createPageHandler(opts.page),
+    global: createGlobalHandler(opts.global),
+    // `preview` deps are optional; pass undefined explicitly so the
+    // factory's `deps?` parameter sees `undefined` rather than `{}` (the
+    // factory branches on `deps?.tokenStore` and `deps?.cookieName`).
+    preview: createPreviewHandler(opts.preview),
+    events: createEventsHandler(opts.events),
+    mcp: createMcpHandler(opts.mcp),
+    template: createTemplateHandler(opts.template),
+    formsList: createFormsListHandler(opts.formsList),
+    formsRead: createFormsReadHandler(opts.formsRead),
+    formsDelete: createFormsDeleteHandler()
+  };
+  const table = buildRouteTable(handlers);
+  const dispatch = async (method, req, ctx) => {
+    const { path: path6 } = await ctx.params;
+    if (!path6 || path6.length === 0) {
+      return new Response(null, { status: 404 });
+    }
+    const key = path6.join("/");
+    const entry = table.get(key);
+    if (!entry) {
+      return new Response(null, { status: 404 });
+    }
+    const handler = entry[method];
+    if (!handler) {
+      const allowed = Object.keys(entry).join(", ");
+      return new Response(null, { status: 405, headers: { Allow: allowed } });
+    }
+    return await handler(req);
+  };
+  return {
+    GET: (req, ctx) => dispatch("GET", req, ctx),
+    POST: (req, ctx) => dispatch("POST", req, ctx),
+    PUT: (req, ctx) => dispatch("PUT", req, ctx),
+    DELETE: (req, ctx) => dispatch("DELETE", req, ctx)
+  };
+}
+
 // src/handlers.ts
 installDefaultAdapterFactories();
 // Annotate the CommonJS export names for ESM import in node:
@@ -2521,5 +2600,6 @@ installDefaultAdapterFactories();
   createPreviewTokenStore,
   createSubmitFormHandler,
   createTaskStore,
-  createTemplateHandler
+  createTemplateHandler,
+  createagntcmsRouteHandler
 });

package/dist/handlers.d.cts

@@ -327,4 +327,68 @@ declare function createFormsReadHandler(deps: FormsReadHandlerDeps): (req: Reque
 
 declare function createFormsDeleteHandler(): (_req: Request) => Promise<Response>;
 
-export { type AgentBridge, type AgentBridgeStatus, AgentUnreachableError, type AssetsHandler, type AssetsHandlerDeps, type CreateAgentBridgeOptions, type DraftHandler, type DraftHandlerDeps, type EventsHandler, type EventsHandlerDeps, type FormsListAdapterInfo, type FormsListHandlerDeps, type FormsReadHandlerDeps, type GlobalHandler, type GlobalHandlerDeps, type McpHandler, type McpHandlerDeps, type PageHandler, type PageHandlerDeps, type PreviewHandler, type PreviewHandlerDeps, type PreviewToken, type PreviewTokenStore, type PreviewTokenStoreOptions, type SubmitHandlerDeps, type Task, type TaskEvent, type TaskId, type TaskSnapshot, type TaskState, type TaskStore, type TemplateHandler, type TemplateHandlerDeps, createAgentBridge, createAssetsHandler, createDraftHandler, createEventsHandler, createFormsDeleteHandler, createFormsListHandler, createFormsReadHandler, createGlobalHandler, createMcpHandler, createPageHandler, createPreviewHandler, createPreviewTokenStore, createSubmitFormHandler, createTaskStore, createTemplateHandler };
+/**
+ * Dependencies for every endpoint the dispatcher serves. Grouped by
+ * underlying handler factory so the template wiring mirrors the v0.2
+ * `_shared.ts` shape one-to-one (each frozen route file passed the same
+ * `deps` object to its factory; the dispatcher merges them at the top).
+ *
+ * `preview` is optional because `createPreviewHandler` has all-optional
+ * deps (cookie name and token store both have defaults / null fallbacks).
+ * Everything else is required: omitting a slice would break a real
+ * endpoint at runtime, and a typed signature catches that at compile time.
+ */
+interface agntcmsRouteHandlerOptions {
+    readonly assets: AssetsHandlerDeps;
+    readonly draft: DraftHandlerDeps;
+    readonly page: PageHandlerDeps;
+    readonly global: GlobalHandlerDeps;
+    readonly preview?: PreviewHandlerDeps;
+    readonly events: EventsHandlerDeps;
+    readonly mcp: McpHandlerDeps;
+    readonly template: TemplateHandlerDeps;
+    readonly formsList: FormsListHandlerDeps;
+    readonly formsRead: FormsReadHandlerDeps;
+}
+/** HTTP methods the dispatcher routes. */
+type DispatcherMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+/**
+ * Shape Next.js 15 passes as the second argument to a catch-all route's
+ * method handlers. `params.path` is a Promise resolving to the path
+ * segments after `/api/agntcms/` — for `assets/upload` it resolves to
+ * `['assets', 'upload']`.
+ */
+interface agntcmsRouteContext {
+    readonly params: Promise<{
+        readonly path: readonly string[];
+    }>;
+}
+interface agntcmsRouteHandler {
+    readonly GET: (req: Request, ctx: agntcmsRouteContext) => Promise<Response>;
+    readonly POST: (req: Request, ctx: agntcmsRouteContext) => Promise<Response>;
+    readonly PUT: (req: Request, ctx: agntcmsRouteContext) => Promise<Response>;
+    readonly DELETE: (req: Request, ctx: agntcmsRouteContext) => Promise<Response>;
+}
+/**
+ * Create the agntcms catch-all route handler for Next.js.
+ *
+ * Usage in the template's frozen `app/api/agntcms/[...path]/route.ts`:
+ *
+ * ```ts
+ * import { createagntcmsRouteHandler } from '@agntcms/next/handlers'
+ * import { contentAdapter, assetAdapter, runtime, taskStore, bridge, ... } from '../_shared'
+ *
+ * export const { GET, POST, PUT, DELETE } = createagntcmsRouteHandler({
+ *   assets: { assetAdapter },
+ *   draft: { contentAdapter, runtime },
+ *   // ... etc
+ * })
+ * ```
+ *
+ * The returned object also exports `PUT` even though no current endpoint
+ * uses it. Exporting all four method symbols keeps the template's
+ * frozen `route.ts` shape stable as new endpoints are added.
+ */
+declare function createagntcmsRouteHandler(opts: agntcmsRouteHandlerOptions): agntcmsRouteHandler;
+
+export { type AgentBridge, type AgentBridgeStatus, AgentUnreachableError, type AssetsHandler, type AssetsHandlerDeps, type CreateAgentBridgeOptions, type DispatcherMethod, type DraftHandler, type DraftHandlerDeps, type EventsHandler, type EventsHandlerDeps, type FormsListAdapterInfo, type FormsListHandlerDeps, type FormsReadHandlerDeps, type GlobalHandler, type GlobalHandlerDeps, type McpHandler, type McpHandlerDeps, type PageHandler, type PageHandlerDeps, type PreviewHandler, type PreviewHandlerDeps, type PreviewToken, type PreviewTokenStore, type PreviewTokenStoreOptions, type SubmitHandlerDeps, type Task, type TaskEvent, type TaskId, type TaskSnapshot, type TaskState, type TaskStore, type TemplateHandler, type TemplateHandlerDeps, type agntcmsRouteContext, type agntcmsRouteHandler, type agntcmsRouteHandlerOptions, createAgentBridge, createAssetsHandler, createDraftHandler, createEventsHandler, createFormsDeleteHandler, createFormsListHandler, createFormsReadHandler, createGlobalHandler, createMcpHandler, createPageHandler, createPreviewHandler, createPreviewTokenStore, createSubmitFormHandler, createTaskStore, createTemplateHandler, createagntcmsRouteHandler };

package/dist/handlers.d.ts

@@ -327,4 +327,68 @@ declare function createFormsReadHandler(deps: FormsReadHandlerDeps): (req: Reque
 
 declare function createFormsDeleteHandler(): (_req: Request) => Promise<Response>;
 
-export { type AgentBridge, type AgentBridgeStatus, AgentUnreachableError, type AssetsHandler, type AssetsHandlerDeps, type CreateAgentBridgeOptions, type DraftHandler, type DraftHandlerDeps, type EventsHandler, type EventsHandlerDeps, type FormsListAdapterInfo, type FormsListHandlerDeps, type FormsReadHandlerDeps, type GlobalHandler, type GlobalHandlerDeps, type McpHandler, type McpHandlerDeps, type PageHandler, type PageHandlerDeps, type PreviewHandler, type PreviewHandlerDeps, type PreviewToken, type PreviewTokenStore, type PreviewTokenStoreOptions, type SubmitHandlerDeps, type Task, type TaskEvent, type TaskId, type TaskSnapshot, type TaskState, type TaskStore, type TemplateHandler, type TemplateHandlerDeps, createAgentBridge, createAssetsHandler, createDraftHandler, createEventsHandler, createFormsDeleteHandler, createFormsListHandler, createFormsReadHandler, createGlobalHandler, createMcpHandler, createPageHandler, createPreviewHandler, createPreviewTokenStore, createSubmitFormHandler, createTaskStore, createTemplateHandler };
+/**
+ * Dependencies for every endpoint the dispatcher serves. Grouped by
+ * underlying handler factory so the template wiring mirrors the v0.2
+ * `_shared.ts` shape one-to-one (each frozen route file passed the same
+ * `deps` object to its factory; the dispatcher merges them at the top).
+ *
+ * `preview` is optional because `createPreviewHandler` has all-optional
+ * deps (cookie name and token store both have defaults / null fallbacks).
+ * Everything else is required: omitting a slice would break a real
+ * endpoint at runtime, and a typed signature catches that at compile time.
+ */
+interface agntcmsRouteHandlerOptions {
+    readonly assets: AssetsHandlerDeps;
+    readonly draft: DraftHandlerDeps;
+    readonly page: PageHandlerDeps;
+    readonly global: GlobalHandlerDeps;
+    readonly preview?: PreviewHandlerDeps;
+    readonly events: EventsHandlerDeps;
+    readonly mcp: McpHandlerDeps;
+    readonly template: TemplateHandlerDeps;
+    readonly formsList: FormsListHandlerDeps;
+    readonly formsRead: FormsReadHandlerDeps;
+}
+/** HTTP methods the dispatcher routes. */
+type DispatcherMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+/**
+ * Shape Next.js 15 passes as the second argument to a catch-all route's
+ * method handlers. `params.path` is a Promise resolving to the path
+ * segments after `/api/agntcms/` — for `assets/upload` it resolves to
+ * `['assets', 'upload']`.
+ */
+interface agntcmsRouteContext {
+    readonly params: Promise<{
+        readonly path: readonly string[];
+    }>;
+}
+interface agntcmsRouteHandler {
+    readonly GET: (req: Request, ctx: agntcmsRouteContext) => Promise<Response>;
+    readonly POST: (req: Request, ctx: agntcmsRouteContext) => Promise<Response>;
+    readonly PUT: (req: Request, ctx: agntcmsRouteContext) => Promise<Response>;
+    readonly DELETE: (req: Request, ctx: agntcmsRouteContext) => Promise<Response>;
+}
+/**
+ * Create the agntcms catch-all route handler for Next.js.
+ *
+ * Usage in the template's frozen `app/api/agntcms/[...path]/route.ts`:
+ *
+ * ```ts
+ * import { createagntcmsRouteHandler } from '@agntcms/next/handlers'
+ * import { contentAdapter, assetAdapter, runtime, taskStore, bridge, ... } from '../_shared'
+ *
+ * export const { GET, POST, PUT, DELETE } = createagntcmsRouteHandler({
+ *   assets: { assetAdapter },
+ *   draft: { contentAdapter, runtime },
+ *   // ... etc
+ * })
+ * ```
+ *
+ * The returned object also exports `PUT` even though no current endpoint
+ * uses it. Exporting all four method symbols keeps the template's
+ * frozen `route.ts` shape stable as new endpoints are added.
+ */
+declare function createagntcmsRouteHandler(opts: agntcmsRouteHandlerOptions): agntcmsRouteHandler;
+
+export { type AgentBridge, type AgentBridgeStatus, AgentUnreachableError, type AssetsHandler, type AssetsHandlerDeps, type CreateAgentBridgeOptions, type DispatcherMethod, type DraftHandler, type DraftHandlerDeps, type EventsHandler, type EventsHandlerDeps, type FormsListAdapterInfo, type FormsListHandlerDeps, type FormsReadHandlerDeps, type GlobalHandler, type GlobalHandlerDeps, type McpHandler, type McpHandlerDeps, type PageHandler, type PageHandlerDeps, type PreviewHandler, type PreviewHandlerDeps, type PreviewToken, type PreviewTokenStore, type PreviewTokenStoreOptions, type SubmitHandlerDeps, type Task, type TaskEvent, type TaskId, type TaskSnapshot, type TaskState, type TaskStore, type TemplateHandler, type TemplateHandlerDeps, type agntcmsRouteContext, type agntcmsRouteHandler, type agntcmsRouteHandlerOptions, createAgentBridge, createAssetsHandler, createDraftHandler, createEventsHandler, createFormsDeleteHandler, createFormsListHandler, createFormsReadHandler, createGlobalHandler, createMcpHandler, createPageHandler, createPreviewHandler, createPreviewTokenStore, createSubmitFormHandler, createTaskStore, createTemplateHandler, createagntcmsRouteHandler };

package/dist/handlers.mjs

@@ -2451,6 +2451,84 @@ function createFormsDeleteHandler() {
   };
 }
 
+// src/handlers/dispatcher.ts
+function buildRouteTable(h) {
+  const table = /* @__PURE__ */ new Map();
+  table.set("assets", { GET: h.assets.list });
+  table.set("assets/upload", { POST: h.assets.upload });
+  table.set("events", { GET: async (req) => h.events.GET(req) });
+  table.set("mcp", { POST: h.mcp.POST });
+  table.set("draft/save", { POST: h.draft.save });
+  table.set("draft/list", { GET: h.draft.list });
+  table.set("draft/publish", { POST: h.draft.publish });
+  table.set("draft/reorder", { POST: h.draft.reorder });
+  table.set("draft/discard", { POST: h.draft.discard });
+  table.set("page/list", { GET: h.page.list });
+  table.set("page/read", { GET: h.page.read });
+  table.set("page/delete", { POST: h.page.deletePage });
+  table.set("page/unpublish", { POST: h.page.unpublish });
+  table.set("page/history", { GET: h.page.listHistory });
+  table.set("page/rollback", { POST: h.page.rollback });
+  table.set("page/rename", { POST: h.page.rename });
+  table.set("page/duplicate", { POST: h.page.duplicate });
+  table.set("global/list", { GET: h.global.list });
+  table.set("global/read", { GET: h.global.read });
+  table.set("global/save", { POST: h.global.save });
+  table.set("global/delete", { DELETE: h.global.delete });
+  table.set("global/history", { GET: h.global.listHistory });
+  table.set("global/rollback", { POST: h.global.rollback });
+  table.set("preview/enter", { POST: async (req) => h.preview.enter(req), GET: async (req) => h.preview.enterWithToken(req) });
+  table.set("preview/exit", { POST: async (req) => h.preview.exit(req) });
+  table.set("preview/issue", { POST: h.preview.issueToken });
+  table.set("template/list", { GET: h.template.list });
+  table.set("forms/list", { GET: h.formsList });
+  table.set("forms/read", { GET: h.formsRead });
+  table.set("forms/delete", { POST: h.formsDelete });
+  return table;
+}
+function createagntcmsRouteHandler(opts) {
+  const handlers = {
+    assets: createAssetsHandler(opts.assets),
+    draft: createDraftHandler(opts.draft),
+    page: createPageHandler(opts.page),
+    global: createGlobalHandler(opts.global),
+    // `preview` deps are optional; pass undefined explicitly so the
+    // factory's `deps?` parameter sees `undefined` rather than `{}` (the
+    // factory branches on `deps?.tokenStore` and `deps?.cookieName`).
+    preview: createPreviewHandler(opts.preview),
+    events: createEventsHandler(opts.events),
+    mcp: createMcpHandler(opts.mcp),
+    template: createTemplateHandler(opts.template),
+    formsList: createFormsListHandler(opts.formsList),
+    formsRead: createFormsReadHandler(opts.formsRead),
+    formsDelete: createFormsDeleteHandler()
+  };
+  const table = buildRouteTable(handlers);
+  const dispatch = async (method, req, ctx) => {
+    const { path: path6 } = await ctx.params;
+    if (!path6 || path6.length === 0) {
+      return new Response(null, { status: 404 });
+    }
+    const key = path6.join("/");
+    const entry = table.get(key);
+    if (!entry) {
+      return new Response(null, { status: 404 });
+    }
+    const handler = entry[method];
+    if (!handler) {
+      const allowed = Object.keys(entry).join(", ");
+      return new Response(null, { status: 405, headers: { Allow: allowed } });
+    }
+    return await handler(req);
+  };
+  return {
+    GET: (req, ctx) => dispatch("GET", req, ctx),
+    POST: (req, ctx) => dispatch("POST", req, ctx),
+    PUT: (req, ctx) => dispatch("PUT", req, ctx),
+    DELETE: (req, ctx) => dispatch("DELETE", req, ctx)
+  };
+}
+
 // src/handlers.ts
 installDefaultAdapterFactories();
 export {
@@ -2469,5 +2547,6 @@ export {
   createPreviewTokenStore,
   createSubmitFormHandler,
   createTaskStore,
-  createTemplateHandler
+  createTemplateHandler,
+  createagntcmsRouteHandler
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agntcms/next",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "agntcms runtime for Next.js: domain model, storage adapters, React components",
   "type": "module",
   "private": false,