@riverbankcms/sdk 0.7.0 → 0.7.2

package/dist/server/{loadPage-DP3nrHBi.d.ts → loadPage-i2r-X5b9.d.ts}

@@ -1,4 +1,4 @@
-import { R as RiverbankClient, S as SiteResponse } from './types-BvcJU7zk.js';
+import { R as RiverbankClient, S as SiteResponse } from './types-DnkRh0UL.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default from 'react';

package/dist/server/metadata.d.mts

@@ -1,6 +1,6 @@
-export { P as PageMetadataInput, g as generatePageMetadata, a as generatePreviewMetadata } from './index-DI_qlYx3.mjs';
-import './loadPage-B8mQUUSo.mjs';
-import './types-1cLz0vnq.mjs';
+export { P as PageMetadataInput, g as generatePageMetadata, a as generatePreviewMetadata } from './index-BL66CU6d.mjs';
+import './loadPage-CxlYLe5K.mjs';
+import './types-MF2AWoKv.mjs';
 import './types-Dsu9wsUh.mjs';
 import '@riverbankcms/ai';
 import './schema-Z6-afHJG.mjs';

package/dist/server/metadata.d.ts

@@ -1,6 +1,6 @@
-export { P as PageMetadataInput, g as generatePageMetadata, a as generatePreviewMetadata } from './index-BTwWvSBu.js';
-import './loadPage-DP3nrHBi.js';
-import './types-BvcJU7zk.js';
+export { P as PageMetadataInput, g as generatePageMetadata, a as generatePreviewMetadata } from './index-CJk9iQQW.js';
+import './loadPage-i2r-X5b9.js';
+import './types-DnkRh0UL.js';
 import './types-CVykEqXN.js';
 import '@riverbankcms/ai';
 import './schema-Z6-afHJG.js';

package/dist/server/metadata.js

@@ -2,7 +2,6 @@
 
 
 var _chunkBNQV3PXPjs = require('./chunk-BNQV3PXP.js');
-require('./chunk-DGUM43GV.js');
 
 
 

package/dist/server/metadata.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/metadata.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACA;AACF,iJAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/metadata.js"}
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/metadata.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,sDAA4B;AAC5B;AACE;AACA;AACF,iJAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/metadata.js"}

package/dist/server/metadata.mjs

@@ -2,7 +2,6 @@ import {
   generatePageMetadata,
   generatePreviewMetadata
 } from "./chunk-SWYWZT3L.mjs";
-import "./chunk-BJTO5JO5.mjs";
 export {
   generatePageMetadata,
   generatePreviewMetadata

package/dist/server/navigation.js

@@ -13,7 +13,6 @@
 
 
 var _chunkEIVISR62js = require('./chunk-EIVISR62.js');
-require('./chunk-DGUM43GV.js');
 
 
 

package/dist/server/navigation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/navigation.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,mxBAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/navigation.js"}
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/navigation.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,sDAA4B;AAC5B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,mxBAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/navigation.js"}

package/dist/server/navigation.mjs

@@ -13,7 +13,6 @@ import {
   isNavLink,
   transformToNavItems
 } from "./chunk-YXA4GAAQ.mjs";
-import "./chunk-BJTO5JO5.mjs";
 export {
   buildLogo,
   buildLogoViewModel,

package/dist/server/next/revalidate.d.mts

@@ -0,0 +1,66 @@
+import { WebhookPayload } from '../webhooks.mjs';
+import 'zod';
+
+/**
+ * Next.js revalidation handler for webhook-based cache invalidation
+ *
+ * This module provides a pre-built API route handler for processing
+ * CMS webhooks and revalidating Next.js cache entries.
+ *
+ * @example One-line setup in consumer site
+ * ```ts
+ * // app/api/revalidate/route.ts
+ * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';
+ * export const POST = createRevalidateHandler();
+ * ```
+ *
+ * @example With custom options
+ * ```ts
+ * // app/api/revalidate/route.ts
+ * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';
+ *
+ * export const POST = createRevalidateHandler({
+ *   onRevalidate: (payload, items) => {
+ *     console.log(`Revalidated ${items.length} items for ${payload.event}`);
+ *   },
+ * });
+ * ```
+ */
+
+/**
+ * Options for the revalidation handler.
+ */
+interface RevalidateHandlerOptions {
+    /**
+     * Override the webhook secret. Defaults to RIVERBANK_WEBHOOK_SECRET env var.
+     */
+    secret?: string;
+    /**
+     * Callback called after successful revalidation.
+     * Useful for logging or analytics.
+     */
+    onRevalidate?: (payload: WebhookPayload, revalidatedItems: string[]) => void;
+}
+/**
+ * Create a Next.js API route handler for webhook revalidation.
+ *
+ * The handler:
+ * 1. Verifies the webhook signature using HMAC-SHA256
+ * 2. Calls `revalidateTag()` for each tag in the payload
+ * 3. Calls `revalidatePath()` if a path is included in the data
+ * 4. Returns a JSON response with the revalidation results
+ *
+ * @param options - Configuration options
+ * @returns A Next.js Route Handler function
+ *
+ * @example
+ * ```ts
+ * // app/api/revalidate/route.ts
+ * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';
+ *
+ * export const POST = createRevalidateHandler();
+ * ```
+ */
+declare function createRevalidateHandler(options?: RevalidateHandlerOptions): (request: Request) => Promise<Response>;
+
+export { type RevalidateHandlerOptions, createRevalidateHandler };

package/dist/server/next/revalidate.d.ts

@@ -0,0 +1,66 @@
+import { WebhookPayload } from '../webhooks.js';
+import 'zod';
+
+/**
+ * Next.js revalidation handler for webhook-based cache invalidation
+ *
+ * This module provides a pre-built API route handler for processing
+ * CMS webhooks and revalidating Next.js cache entries.
+ *
+ * @example One-line setup in consumer site
+ * ```ts
+ * // app/api/revalidate/route.ts
+ * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';
+ * export const POST = createRevalidateHandler();
+ * ```
+ *
+ * @example With custom options
+ * ```ts
+ * // app/api/revalidate/route.ts
+ * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';
+ *
+ * export const POST = createRevalidateHandler({
+ *   onRevalidate: (payload, items) => {
+ *     console.log(`Revalidated ${items.length} items for ${payload.event}`);
+ *   },
+ * });
+ * ```
+ */
+
+/**
+ * Options for the revalidation handler.
+ */
+interface RevalidateHandlerOptions {
+    /**
+     * Override the webhook secret. Defaults to RIVERBANK_WEBHOOK_SECRET env var.
+     */
+    secret?: string;
+    /**
+     * Callback called after successful revalidation.
+     * Useful for logging or analytics.
+     */
+    onRevalidate?: (payload: WebhookPayload, revalidatedItems: string[]) => void;
+}
+/**
+ * Create a Next.js API route handler for webhook revalidation.
+ *
+ * The handler:
+ * 1. Verifies the webhook signature using HMAC-SHA256
+ * 2. Calls `revalidateTag()` for each tag in the payload
+ * 3. Calls `revalidatePath()` if a path is included in the data
+ * 4. Returns a JSON response with the revalidation results
+ *
+ * @param options - Configuration options
+ * @returns A Next.js Route Handler function
+ *
+ * @example
+ * ```ts
+ * // app/api/revalidate/route.ts
+ * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';
+ *
+ * export const POST = createRevalidateHandler();
+ * ```
+ */
+declare function createRevalidateHandler(options?: RevalidateHandlerOptions): (request: Request) => Promise<Response>;
+
+export { type RevalidateHandlerOptions, createRevalidateHandler };

package/dist/server/next/revalidate.js

@@ -0,0 +1,59 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+var _chunkVODFQMUWjs = require('../chunk-VODFQMUW.js');
+
+// src/next/revalidate.ts
+var _cache = require('next/cache');
+function createRevalidateHandler(options = {}) {
+  return async function handleRevalidateRequest(request) {
+    const secret = _nullishCoalesce(options.secret, () => ( process.env.RIVERBANK_WEBHOOK_SECRET));
+    if (!secret) {
+      console.error("[Riverbank] RIVERBANK_WEBHOOK_SECRET not configured");
+      return Response.json(
+        { error: "Webhook secret not configured" },
+        { status: 500 }
+      );
+    }
+    const body = await request.text();
+    const signature = request.headers.get("x-riverbank-signature");
+    if (!signature || !_chunkVODFQMUWjs.verifyWebhookSignature.call(void 0, body, signature, secret)) {
+      return Response.json({ error: "Invalid signature" }, { status: 401 });
+    }
+    const parseResult = _chunkVODFQMUWjs.parseWebhookPayload.call(void 0, body);
+    if (!parseResult.success) {
+      return Response.json({ error: parseResult.error }, { status: 400 });
+    }
+    const payload = parseResult.payload;
+    const revalidated = [];
+    if (_optionalChain([payload, 'access', _ => _.tags, 'optionalAccess', _2 => _2.length])) {
+      for (const tag of payload.tags) {
+        _cache.revalidateTag.call(void 0, tag);
+        revalidated.push(`tag:${tag}`);
+      }
+    }
+    const path = _optionalChain([payload, 'access', _3 => _3.data, 'optionalAccess', _4 => _4.path]);
+    if (path) {
+      _cache.revalidatePath.call(void 0, path);
+      revalidated.push(`path:${path}`);
+    }
+    if (revalidated.length > 0) {
+      console.log(
+        `[Riverbank] Revalidated: ${revalidated.join(", ")} (event: ${payload.event})`
+      );
+    }
+    if (options.onRevalidate) {
+      options.onRevalidate(payload, revalidated);
+    }
+    return Response.json({
+      revalidated: true,
+      items: revalidated,
+      event: payload.event,
+      timestamp: Date.now()
+    });
+  };
+}
+
+
+exports.createRevalidateHandler = createRevalidateHandler;
+//# sourceMappingURL=revalidate.js.map

package/dist/server/next/revalidate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/next/revalidate.js","../../../src/next/revalidate.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,uDAA6B;AAC7B;AACA;ACqBA,mCAA8C;AA2CvC,SAAS,uBAAA,CACd,QAAA,EAAoC,CAAC,CAAA,EACI;AACzC,EAAA,OAAO,MAAA,SAAe,uBAAA,CAAwB,OAAA,EAAqC;AAEjF,IAAA,MAAM,OAAA,mBAAS,OAAA,CAAQ,MAAA,UAAU,OAAA,CAAQ,GAAA,CAAI,0BAAA;AAE7C,IAAA,GAAA,CAAI,CAAC,MAAA,EAAQ;AACX,MAAA,OAAA,CAAQ,KAAA,CAAM,qDAAqD,CAAA;AACnE,MAAA,OAAO,QAAA,CAAS,IAAA;AAAA,QACd,EAAE,KAAA,EAAO,gCAAgC,CAAA;AAAA,QACzC,EAAE,MAAA,EAAQ,IAAI;AAAA,MAChB,CAAA;AAAA,IACF;AAGA,IAAA,MAAM,KAAA,EAAO,MAAM,OAAA,CAAQ,IAAA,CAAK,CAAA;AAChC,IAAA,MAAM,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,uBAAuB,CAAA;AAG7D,IAAA,GAAA,CAAI,CAAC,UAAA,GAAa,CAAC,qDAAA,IAAuB,EAAM,SAAA,EAAW,MAAM,CAAA,EAAG;AAClE,MAAA,OAAO,QAAA,CAAS,IAAA,CAAK,EAAE,KAAA,EAAO,oBAAoB,CAAA,EAAG,EAAE,MAAA,EAAQ,IAAI,CAAC,CAAA;AAAA,IACtE;AAGA,IAAA,MAAM,YAAA,EAAc,kDAAA,IAAwB,CAAA;AAC5C,IAAA,GAAA,CAAI,CAAC,WAAA,CAAY,OAAA,EAAS;AACxB,MAAA,OAAO,QAAA,CAAS,IAAA,CAAK,EAAE,KAAA,EAAO,WAAA,CAAY,MAAM,CAAA,EAAG,EAAE,MAAA,EAAQ,IAAI,CAAC,CAAA;AAAA,IACpE;AACA,IAAA,MAAM,QAAA,EAAU,WAAA,CAAY,OAAA;AAC5B,IAAA,MAAM,YAAA,EAAwB,CAAC,CAAA;AAG/B,IAAA,GAAA,iBAAI,OAAA,mBAAQ,IAAA,6BAAM,QAAA,EAAQ;AACxB,MAAA,IAAA,CAAA,MAAW,IAAA,GAAO,OAAA,CAAQ,IAAA,EAAM;AAC9B,QAAA,kCAAA,GAAiB,CAAA;AACjB,QAAA,WAAA,CAAY,IAAA,CAAK,CAAA,IAAA,EAAO,GAAG,CAAA,CAAA;AAC7B,MAAA;AACF,IAAA;AAG2B,IAAA;AACjB,IAAA;AACW,MAAA;AACU,MAAA;AAC/B,IAAA;AAG4B,IAAA;AAClB,MAAA;AACsB,QAAA;AAC9B,MAAA;AACF,IAAA;AAG0B,IAAA;AACM,MAAA;AAChC,IAAA;AAEqB,IAAA;AACN,MAAA;AACN,MAAA;AACQ,MAAA;AACK,MAAA;AACrB,IAAA;AACH,EAAA;AACF;ADhFoC;AACA;AACA","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/next/revalidate.js","sourcesContent":[null,"/**\n * Next.js revalidation handler for webhook-based cache invalidation\n *\n * This module provides a pre-built API route handler for processing\n * CMS webhooks and revalidating Next.js cache entries.\n *\n * @example One-line setup in consumer site\n * ```ts\n * // app/api/revalidate/route.ts\n * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';\n * export const POST = createRevalidateHandler();\n * ```\n *\n * @example With custom options\n * ```ts\n * // app/api/revalidate/route.ts\n * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';\n *\n * export const POST = createRevalidateHandler({\n *   onRevalidate: (payload, items) => {\n *     console.log(`Revalidated ${items.length} items for ${payload.event}`);\n *   },\n * });\n * ```\n */\n\nimport { revalidateTag, revalidatePath } from 'next/cache';\nimport {\n  verifyWebhookSignature,\n  parseWebhookPayload,\n  type WebhookPayload,\n} from '../webhooks/verify';\n\n/**\n * Options for the revalidation handler.\n */\nexport interface RevalidateHandlerOptions {\n  /**\n   * Override the webhook secret. Defaults to RIVERBANK_WEBHOOK_SECRET env var.\n   */\n  secret?: string;\n\n  /**\n   * Callback called after successful revalidation.\n   * Useful for logging or analytics.\n   */\n  onRevalidate?: (payload: WebhookPayload, revalidatedItems: string[]) => void;\n}\n\n/**\n * Create a Next.js API route handler for webhook revalidation.\n *\n * The handler:\n * 1. Verifies the webhook signature using HMAC-SHA256\n * 2. Calls `revalidateTag()` for each tag in the payload\n * 3. Calls `revalidatePath()` if a path is included in the data\n * 4. Returns a JSON response with the revalidation results\n *\n * @param options - Configuration options\n * @returns A Next.js Route Handler function\n *\n * @example\n * ```ts\n * // app/api/revalidate/route.ts\n * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';\n *\n * export const POST = createRevalidateHandler();\n * ```\n */\nexport function createRevalidateHandler(\n  options: RevalidateHandlerOptions = {}\n): (request: Request) => Promise<Response> {\n  return async function handleRevalidateRequest(request: Request): Promise<Response> {\n    // Get webhook secret\n    const secret = options.secret ?? process.env.RIVERBANK_WEBHOOK_SECRET;\n\n    if (!secret) {\n      console.error('[Riverbank] RIVERBANK_WEBHOOK_SECRET not configured');\n      return Response.json(\n        { error: 'Webhook secret not configured' },\n        { status: 500 }\n      );\n    }\n\n    // Read request body\n    const body = await request.text();\n    const signature = request.headers.get('x-riverbank-signature');\n\n    // Verify signature\n    if (!signature || !verifyWebhookSignature(body, signature, secret)) {\n      return Response.json({ error: 'Invalid signature' }, { status: 401 });\n    }\n\n    // Parse and validate payload\n    const parseResult = parseWebhookPayload(body);\n    if (!parseResult.success) {\n      return Response.json({ error: parseResult.error }, { status: 400 });\n    }\n    const payload = parseResult.payload;\n    const revalidated: string[] = [];\n\n    // Tag-based revalidation (preferred)\n    if (payload.tags?.length) {\n      for (const tag of payload.tags) {\n        revalidateTag(tag);\n        revalidated.push(`tag:${tag}`);\n      }\n    }\n\n    // Path-based fallback (from data.path if present)\n    const path = payload.data?.path as string | undefined;\n    if (path) {\n      revalidatePath(path);\n      revalidated.push(`path:${path}`);\n    }\n\n    // Log revalidation\n    if (revalidated.length > 0) {\n      console.log(\n        `[Riverbank] Revalidated: ${revalidated.join(', ')} (event: ${payload.event})`\n      );\n    }\n\n    // Call optional callback\n    if (options.onRevalidate) {\n      options.onRevalidate(payload, revalidated);\n    }\n\n    return Response.json({\n      revalidated: true,\n      items: revalidated,\n      event: payload.event,\n      timestamp: Date.now(),\n    });\n  };\n}\n"]}

package/dist/server/next/revalidate.mjs

@@ -0,0 +1,59 @@
+import {
+  parseWebhookPayload,
+  verifyWebhookSignature
+} from "../chunk-AET56TQX.mjs";
+
+// src/next/revalidate.ts
+import { revalidateTag, revalidatePath } from "next/cache";
+function createRevalidateHandler(options = {}) {
+  return async function handleRevalidateRequest(request) {
+    const secret = options.secret ?? process.env.RIVERBANK_WEBHOOK_SECRET;
+    if (!secret) {
+      console.error("[Riverbank] RIVERBANK_WEBHOOK_SECRET not configured");
+      return Response.json(
+        { error: "Webhook secret not configured" },
+        { status: 500 }
+      );
+    }
+    const body = await request.text();
+    const signature = request.headers.get("x-riverbank-signature");
+    if (!signature || !verifyWebhookSignature(body, signature, secret)) {
+      return Response.json({ error: "Invalid signature" }, { status: 401 });
+    }
+    const parseResult = parseWebhookPayload(body);
+    if (!parseResult.success) {
+      return Response.json({ error: parseResult.error }, { status: 400 });
+    }
+    const payload = parseResult.payload;
+    const revalidated = [];
+    if (payload.tags?.length) {
+      for (const tag of payload.tags) {
+        revalidateTag(tag);
+        revalidated.push(`tag:${tag}`);
+      }
+    }
+    const path = payload.data?.path;
+    if (path) {
+      revalidatePath(path);
+      revalidated.push(`path:${path}`);
+    }
+    if (revalidated.length > 0) {
+      console.log(
+        `[Riverbank] Revalidated: ${revalidated.join(", ")} (event: ${payload.event})`
+      );
+    }
+    if (options.onRevalidate) {
+      options.onRevalidate(payload, revalidated);
+    }
+    return Response.json({
+      revalidated: true,
+      items: revalidated,
+      event: payload.event,
+      timestamp: Date.now()
+    });
+  };
+}
+export {
+  createRevalidateHandler
+};
+//# sourceMappingURL=revalidate.mjs.map

package/dist/server/next/revalidate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/next/revalidate.ts"],"sourcesContent":["/**\n * Next.js revalidation handler for webhook-based cache invalidation\n *\n * This module provides a pre-built API route handler for processing\n * CMS webhooks and revalidating Next.js cache entries.\n *\n * @example One-line setup in consumer site\n * ```ts\n * // app/api/revalidate/route.ts\n * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';\n * export const POST = createRevalidateHandler();\n * ```\n *\n * @example With custom options\n * ```ts\n * // app/api/revalidate/route.ts\n * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';\n *\n * export const POST = createRevalidateHandler({\n *   onRevalidate: (payload, items) => {\n *     console.log(`Revalidated ${items.length} items for ${payload.event}`);\n *   },\n * });\n * ```\n */\n\nimport { revalidateTag, revalidatePath } from 'next/cache';\nimport {\n  verifyWebhookSignature,\n  parseWebhookPayload,\n  type WebhookPayload,\n} from '../webhooks/verify';\n\n/**\n * Options for the revalidation handler.\n */\nexport interface RevalidateHandlerOptions {\n  /**\n   * Override the webhook secret. Defaults to RIVERBANK_WEBHOOK_SECRET env var.\n   */\n  secret?: string;\n\n  /**\n   * Callback called after successful revalidation.\n   * Useful for logging or analytics.\n   */\n  onRevalidate?: (payload: WebhookPayload, revalidatedItems: string[]) => void;\n}\n\n/**\n * Create a Next.js API route handler for webhook revalidation.\n *\n * The handler:\n * 1. Verifies the webhook signature using HMAC-SHA256\n * 2. Calls `revalidateTag()` for each tag in the payload\n * 3. Calls `revalidatePath()` if a path is included in the data\n * 4. Returns a JSON response with the revalidation results\n *\n * @param options - Configuration options\n * @returns A Next.js Route Handler function\n *\n * @example\n * ```ts\n * // app/api/revalidate/route.ts\n * import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate';\n *\n * export const POST = createRevalidateHandler();\n * ```\n */\nexport function createRevalidateHandler(\n  options: RevalidateHandlerOptions = {}\n): (request: Request) => Promise<Response> {\n  return async function handleRevalidateRequest(request: Request): Promise<Response> {\n    // Get webhook secret\n    const secret = options.secret ?? process.env.RIVERBANK_WEBHOOK_SECRET;\n\n    if (!secret) {\n      console.error('[Riverbank] RIVERBANK_WEBHOOK_SECRET not configured');\n      return Response.json(\n        { error: 'Webhook secret not configured' },\n        { status: 500 }\n      );\n    }\n\n    // Read request body\n    const body = await request.text();\n    const signature = request.headers.get('x-riverbank-signature');\n\n    // Verify signature\n    if (!signature || !verifyWebhookSignature(body, signature, secret)) {\n      return Response.json({ error: 'Invalid signature' }, { status: 401 });\n    }\n\n    // Parse and validate payload\n    const parseResult = parseWebhookPayload(body);\n    if (!parseResult.success) {\n      return Response.json({ error: parseResult.error }, { status: 400 });\n    }\n    const payload = parseResult.payload;\n    const revalidated: string[] = [];\n\n    // Tag-based revalidation (preferred)\n    if (payload.tags?.length) {\n      for (const tag of payload.tags) {\n        revalidateTag(tag);\n        revalidated.push(`tag:${tag}`);\n      }\n    }\n\n    // Path-based fallback (from data.path if present)\n    const path = payload.data?.path as string | undefined;\n    if (path) {\n      revalidatePath(path);\n      revalidated.push(`path:${path}`);\n    }\n\n    // Log revalidation\n    if (revalidated.length > 0) {\n      console.log(\n        `[Riverbank] Revalidated: ${revalidated.join(', ')} (event: ${payload.event})`\n      );\n    }\n\n    // Call optional callback\n    if (options.onRevalidate) {\n      options.onRevalidate(payload, revalidated);\n    }\n\n    return Response.json({\n      revalidated: true,\n      items: revalidated,\n      event: payload.event,\n      timestamp: Date.now(),\n    });\n  };\n}\n"],"mappings":";;;;;;AA0BA,SAAS,eAAe,sBAAsB;AA2CvC,SAAS,wBACd,UAAoC,CAAC,GACI;AACzC,SAAO,eAAe,wBAAwB,SAAqC;AAEjF,UAAM,SAAS,QAAQ,UAAU,QAAQ,IAAI;AAE7C,QAAI,CAAC,QAAQ;AACX,cAAQ,MAAM,qDAAqD;AACnE,aAAO,SAAS;AAAA,QACd,EAAE,OAAO,gCAAgC;AAAA,QACzC,EAAE,QAAQ,IAAI;AAAA,MAChB;AAAA,IACF;AAGA,UAAM,OAAO,MAAM,QAAQ,KAAK;AAChC,UAAM,YAAY,QAAQ,QAAQ,IAAI,uBAAuB;AAG7D,QAAI,CAAC,aAAa,CAAC,uBAAuB,MAAM,WAAW,MAAM,GAAG;AAClE,aAAO,SAAS,KAAK,EAAE,OAAO,oBAAoB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,IACtE;AAGA,UAAM,cAAc,oBAAoB,IAAI;AAC5C,QAAI,CAAC,YAAY,SAAS;AACxB,aAAO,SAAS,KAAK,EAAE,OAAO,YAAY,MAAM,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,IACpE;AACA,UAAM,UAAU,YAAY;AAC5B,UAAM,cAAwB,CAAC;AAG/B,QAAI,QAAQ,MAAM,QAAQ;AACxB,iBAAW,OAAO,QAAQ,MAAM;AAC9B,sBAAc,GAAG;AACjB,oBAAY,KAAK,OAAO,GAAG,EAAE;AAAA,MAC/B;AAAA,IACF;AAGA,UAAM,OAAO,QAAQ,MAAM;AAC3B,QAAI,MAAM;AACR,qBAAe,IAAI;AACnB,kBAAY,KAAK,QAAQ,IAAI,EAAE;AAAA,IACjC;AAGA,QAAI,YAAY,SAAS,GAAG;AAC1B,cAAQ;AAAA,QACN,4BAA4B,YAAY,KAAK,IAAI,CAAC,YAAY,QAAQ,KAAK;AAAA,MAC7E;AAAA,IACF;AAGA,QAAI,QAAQ,cAAc;AACxB,cAAQ,aAAa,SAAS,WAAW;AAAA,IAC3C;AAEA,WAAO,SAAS,KAAK;AAAA,MACnB,aAAa;AAAA,MACb,OAAO;AAAA,MACP,OAAO,QAAQ;AAAA,MACf,WAAW,KAAK,IAAI;AAAA,IACtB,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/server/next/tags.d.mts

@@ -0,0 +1,78 @@
+/**
+ * Tag generation helpers for Next.js cache invalidation
+ *
+ * These helpers generate consistent cache tags for use with Next.js
+ * `unstable_cache` and `revalidateTag` APIs.
+ *
+ * Tag naming convention:
+ * - `riverbank` - Global tag that invalidates ALL Riverbank data
+ * - `riverbank:<resource>` - Collection tag (e.g., `riverbank:pages`)
+ * - `riverbank:<resource>:<id>` - Specific resource tag (e.g., `riverbank:page:page-123`)
+ *
+ * @example
+ * ```tsx
+ * // Consumer site: lib/cms-fetchers.ts
+ * import { unstable_cache } from 'next/cache';
+ * import { loadPage } from '@riverbankcms/sdk';
+ * import { getPageTags } from '@riverbankcms/sdk/next/tags';
+ *
+ * export const getCachedPage = unstable_cache(
+ *   async (path: string) => loadPage({ client, siteId, path }),
+ *   ['riverbank-page'],
+ *   { tags: getPageTags(), revalidate: 300 }
+ * );
+ * ```
+ */
+/**
+ * Global tag that invalidates ALL Riverbank data.
+ * Revalidating this tag will refresh everything.
+ */
+declare const RIVERBANK_GLOBAL_TAG = "riverbank";
+/**
+ * Generate tags for site-level data (settings, theme).
+ *
+ * @returns Array of tags: ['riverbank', 'riverbank:site']
+ */
+declare function getSiteTags(): string[];
+/**
+ * Generate tags for page data.
+ *
+ * @param pageId - Optional specific page ID to include
+ * @returns Array of tags including global, pages collection, and optionally page-specific
+ *
+ * @example
+ * ```ts
+ * getPageTags()           // ['riverbank', 'riverbank:pages']
+ * getPageTags('page-123') // ['riverbank', 'riverbank:pages', 'riverbank:page:page-123']
+ * ```
+ */
+declare function getPageTags(pageId?: string): string[];
+/**
+ * Generate tags for content entries.
+ *
+ * @param contentTypeSlug - The content type slug (e.g., 'blog-post', 'event')
+ * @param entryId - Optional specific entry ID to include
+ * @returns Array of tags including global, content-type, and optionally entry-specific
+ *
+ * @example
+ * ```ts
+ * getEntryTags('blog-post')              // ['riverbank', 'riverbank:content-type:blog-post']
+ * getEntryTags('blog-post', 'entry-456') // ['riverbank', 'riverbank:content-type:blog-post', 'riverbank:entry:entry-456']
+ * ```
+ */
+declare function getEntryTags(contentTypeSlug: string, entryId?: string): string[];
+/**
+ * Generate tags for navigation menus.
+ *
+ * @param menuKey - Optional specific menu key to include
+ * @returns Array of tags including global, navigation collection, and optionally menu-specific
+ *
+ * @example
+ * ```ts
+ * getNavigationTags()       // ['riverbank', 'riverbank:navigation']
+ * getNavigationTags('main') // ['riverbank', 'riverbank:navigation', 'riverbank:navigation:main']
+ * ```
+ */
+declare function getNavigationTags(menuKey?: string): string[];
+
+export { RIVERBANK_GLOBAL_TAG, getEntryTags, getNavigationTags, getPageTags, getSiteTags };

package/dist/server/next/tags.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Tag generation helpers for Next.js cache invalidation
+ *
+ * These helpers generate consistent cache tags for use with Next.js
+ * `unstable_cache` and `revalidateTag` APIs.
+ *
+ * Tag naming convention:
+ * - `riverbank` - Global tag that invalidates ALL Riverbank data
+ * - `riverbank:<resource>` - Collection tag (e.g., `riverbank:pages`)
+ * - `riverbank:<resource>:<id>` - Specific resource tag (e.g., `riverbank:page:page-123`)
+ *
+ * @example
+ * ```tsx
+ * // Consumer site: lib/cms-fetchers.ts
+ * import { unstable_cache } from 'next/cache';
+ * import { loadPage } from '@riverbankcms/sdk';
+ * import { getPageTags } from '@riverbankcms/sdk/next/tags';
+ *
+ * export const getCachedPage = unstable_cache(
+ *   async (path: string) => loadPage({ client, siteId, path }),
+ *   ['riverbank-page'],
+ *   { tags: getPageTags(), revalidate: 300 }
+ * );
+ * ```
+ */
+/**
+ * Global tag that invalidates ALL Riverbank data.
+ * Revalidating this tag will refresh everything.
+ */
+declare const RIVERBANK_GLOBAL_TAG = "riverbank";
+/**
+ * Generate tags for site-level data (settings, theme).
+ *
+ * @returns Array of tags: ['riverbank', 'riverbank:site']
+ */
+declare function getSiteTags(): string[];
+/**
+ * Generate tags for page data.
+ *
+ * @param pageId - Optional specific page ID to include
+ * @returns Array of tags including global, pages collection, and optionally page-specific
+ *
+ * @example
+ * ```ts
+ * getPageTags()           // ['riverbank', 'riverbank:pages']
+ * getPageTags('page-123') // ['riverbank', 'riverbank:pages', 'riverbank:page:page-123']
+ * ```
+ */
+declare function getPageTags(pageId?: string): string[];
+/**
+ * Generate tags for content entries.
+ *
+ * @param contentTypeSlug - The content type slug (e.g., 'blog-post', 'event')
+ * @param entryId - Optional specific entry ID to include
+ * @returns Array of tags including global, content-type, and optionally entry-specific
+ *
+ * @example
+ * ```ts
+ * getEntryTags('blog-post')              // ['riverbank', 'riverbank:content-type:blog-post']
+ * getEntryTags('blog-post', 'entry-456') // ['riverbank', 'riverbank:content-type:blog-post', 'riverbank:entry:entry-456']
+ * ```
+ */
+declare function getEntryTags(contentTypeSlug: string, entryId?: string): string[];
+/**
+ * Generate tags for navigation menus.
+ *
+ * @param menuKey - Optional specific menu key to include
+ * @returns Array of tags including global, navigation collection, and optionally menu-specific
+ *
+ * @example
+ * ```ts
+ * getNavigationTags()       // ['riverbank', 'riverbank:navigation']
+ * getNavigationTags('main') // ['riverbank', 'riverbank:navigation', 'riverbank:navigation:main']
+ * ```
+ */
+declare function getNavigationTags(menuKey?: string): string[];
+
+export { RIVERBANK_GLOBAL_TAG, getEntryTags, getNavigationTags, getPageTags, getSiteTags };

package/dist/server/next/tags.js

@@ -0,0 +1,34 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/next/tags.ts
+var RIVERBANK_GLOBAL_TAG = "riverbank";
+function getSiteTags() {
+  return [RIVERBANK_GLOBAL_TAG, "riverbank:site"];
+}
+function getPageTags(pageId) {
+  const tags = [RIVERBANK_GLOBAL_TAG, "riverbank:pages"];
+  if (pageId) {
+    tags.push(`riverbank:page:${pageId}`);
+  }
+  return tags;
+}
+function getEntryTags(contentTypeSlug, entryId) {
+  const tags = [RIVERBANK_GLOBAL_TAG, `riverbank:content-type:${contentTypeSlug}`];
+  if (entryId) {
+    tags.push(`riverbank:entry:${entryId}`);
+  }
+  return tags;
+}
+function getNavigationTags(menuKey) {
+  const tags = [RIVERBANK_GLOBAL_TAG, "riverbank:navigation"];
+  if (menuKey) {
+    tags.push(`riverbank:navigation:${menuKey}`);
+  }
+  return tags;
+}
+
+
+
+
+
+
+exports.RIVERBANK_GLOBAL_TAG = RIVERBANK_GLOBAL_TAG; exports.getEntryTags = getEntryTags; exports.getNavigationTags = getNavigationTags; exports.getPageTags = getPageTags; exports.getSiteTags = getSiteTags;
+//# sourceMappingURL=tags.js.map

package/dist/server/next/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/next/tags.js","../../../src/next/tags.ts"],"names":[],"mappings":"AAAA;AC8BO,IAAM,qBAAA,EAAuB,WAAA;AAO7B,SAAS,WAAA,CAAA,EAAwB;AACtC,EAAA,OAAO,CAAC,oBAAA,EAAsB,gBAAgB,CAAA;AAChD;AAcO,SAAS,WAAA,CAAY,MAAA,EAA2B;AACrD,EAAA,MAAM,KAAA,EAAO,CAAC,oBAAA,EAAsB,iBAAiB,CAAA;AACrD,EAAA,GAAA,CAAI,MAAA,EAAQ;AACV,IAAA,IAAA,CAAK,IAAA,CAAK,CAAA,eAAA,EAAkB,MAAM,CAAA,CAAA;AACpC,EAAA;AACO,EAAA;AACT;AAesD;AAChB,EAAA;AACvB,EAAA;AACkB,IAAA;AAC/B,EAAA;AACO,EAAA;AACT;AAc8D;AACxB,EAAA;AACvB,EAAA;AACuB,IAAA;AACpC,EAAA;AACO,EAAA;AACT;AD1EuC;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/next/tags.js","sourcesContent":[null,"/**\n * Tag generation helpers for Next.js cache invalidation\n *\n * These helpers generate consistent cache tags for use with Next.js\n * `unstable_cache` and `revalidateTag` APIs.\n *\n * Tag naming convention:\n * - `riverbank` - Global tag that invalidates ALL Riverbank data\n * - `riverbank:<resource>` - Collection tag (e.g., `riverbank:pages`)\n * - `riverbank:<resource>:<id>` - Specific resource tag (e.g., `riverbank:page:page-123`)\n *\n * @example\n * ```tsx\n * // Consumer site: lib/cms-fetchers.ts\n * import { unstable_cache } from 'next/cache';\n * import { loadPage } from '@riverbankcms/sdk';\n * import { getPageTags } from '@riverbankcms/sdk/next/tags';\n *\n * export const getCachedPage = unstable_cache(\n *   async (path: string) => loadPage({ client, siteId, path }),\n *   ['riverbank-page'],\n *   { tags: getPageTags(), revalidate: 300 }\n * );\n * ```\n */\n\n/**\n * Global tag that invalidates ALL Riverbank data.\n * Revalidating this tag will refresh everything.\n */\nexport const RIVERBANK_GLOBAL_TAG = 'riverbank';\n\n/**\n * Generate tags for site-level data (settings, theme).\n *\n * @returns Array of tags: ['riverbank', 'riverbank:site']\n */\nexport function getSiteTags(): string[] {\n  return [RIVERBANK_GLOBAL_TAG, 'riverbank:site'];\n}\n\n/**\n * Generate tags for page data.\n *\n * @param pageId - Optional specific page ID to include\n * @returns Array of tags including global, pages collection, and optionally page-specific\n *\n * @example\n * ```ts\n * getPageTags()           // ['riverbank', 'riverbank:pages']\n * getPageTags('page-123') // ['riverbank', 'riverbank:pages', 'riverbank:page:page-123']\n * ```\n */\nexport function getPageTags(pageId?: string): string[] {\n  const tags = [RIVERBANK_GLOBAL_TAG, 'riverbank:pages'];\n  if (pageId) {\n    tags.push(`riverbank:page:${pageId}`);\n  }\n  return tags;\n}\n\n/**\n * Generate tags for content entries.\n *\n * @param contentTypeSlug - The content type slug (e.g., 'blog-post', 'event')\n * @param entryId - Optional specific entry ID to include\n * @returns Array of tags including global, content-type, and optionally entry-specific\n *\n * @example\n * ```ts\n * getEntryTags('blog-post')              // ['riverbank', 'riverbank:content-type:blog-post']\n * getEntryTags('blog-post', 'entry-456') // ['riverbank', 'riverbank:content-type:blog-post', 'riverbank:entry:entry-456']\n * ```\n */\nexport function getEntryTags(contentTypeSlug: string, entryId?: string): string[] {\n  const tags = [RIVERBANK_GLOBAL_TAG, `riverbank:content-type:${contentTypeSlug}`];\n  if (entryId) {\n    tags.push(`riverbank:entry:${entryId}`);\n  }\n  return tags;\n}\n\n/**\n * Generate tags for navigation menus.\n *\n * @param menuKey - Optional specific menu key to include\n * @returns Array of tags including global, navigation collection, and optionally menu-specific\n *\n * @example\n * ```ts\n * getNavigationTags()       // ['riverbank', 'riverbank:navigation']\n * getNavigationTags('main') // ['riverbank', 'riverbank:navigation', 'riverbank:navigation:main']\n * ```\n */\nexport function getNavigationTags(menuKey?: string): string[] {\n  const tags = [RIVERBANK_GLOBAL_TAG, 'riverbank:navigation'];\n  if (menuKey) {\n    tags.push(`riverbank:navigation:${menuKey}`);\n  }\n  return tags;\n}\n"]}

package/dist/server/next/tags.mjs

@@ -0,0 +1,34 @@
+// src/next/tags.ts
+var RIVERBANK_GLOBAL_TAG = "riverbank";
+function getSiteTags() {
+  return [RIVERBANK_GLOBAL_TAG, "riverbank:site"];
+}
+function getPageTags(pageId) {
+  const tags = [RIVERBANK_GLOBAL_TAG, "riverbank:pages"];
+  if (pageId) {
+    tags.push(`riverbank:page:${pageId}`);
+  }
+  return tags;
+}
+function getEntryTags(contentTypeSlug, entryId) {
+  const tags = [RIVERBANK_GLOBAL_TAG, `riverbank:content-type:${contentTypeSlug}`];
+  if (entryId) {
+    tags.push(`riverbank:entry:${entryId}`);
+  }
+  return tags;
+}
+function getNavigationTags(menuKey) {
+  const tags = [RIVERBANK_GLOBAL_TAG, "riverbank:navigation"];
+  if (menuKey) {
+    tags.push(`riverbank:navigation:${menuKey}`);
+  }
+  return tags;
+}
+export {
+  RIVERBANK_GLOBAL_TAG,
+  getEntryTags,
+  getNavigationTags,
+  getPageTags,
+  getSiteTags
+};
+//# sourceMappingURL=tags.mjs.map

package/dist/server/next/tags.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/next/tags.ts"],"sourcesContent":["/**\n * Tag generation helpers for Next.js cache invalidation\n *\n * These helpers generate consistent cache tags for use with Next.js\n * `unstable_cache` and `revalidateTag` APIs.\n *\n * Tag naming convention:\n * - `riverbank` - Global tag that invalidates ALL Riverbank data\n * - `riverbank:<resource>` - Collection tag (e.g., `riverbank:pages`)\n * - `riverbank:<resource>:<id>` - Specific resource tag (e.g., `riverbank:page:page-123`)\n *\n * @example\n * ```tsx\n * // Consumer site: lib/cms-fetchers.ts\n * import { unstable_cache } from 'next/cache';\n * import { loadPage } from '@riverbankcms/sdk';\n * import { getPageTags } from '@riverbankcms/sdk/next/tags';\n *\n * export const getCachedPage = unstable_cache(\n *   async (path: string) => loadPage({ client, siteId, path }),\n *   ['riverbank-page'],\n *   { tags: getPageTags(), revalidate: 300 }\n * );\n * ```\n */\n\n/**\n * Global tag that invalidates ALL Riverbank data.\n * Revalidating this tag will refresh everything.\n */\nexport const RIVERBANK_GLOBAL_TAG = 'riverbank';\n\n/**\n * Generate tags for site-level data (settings, theme).\n *\n * @returns Array of tags: ['riverbank', 'riverbank:site']\n */\nexport function getSiteTags(): string[] {\n  return [RIVERBANK_GLOBAL_TAG, 'riverbank:site'];\n}\n\n/**\n * Generate tags for page data.\n *\n * @param pageId - Optional specific page ID to include\n * @returns Array of tags including global, pages collection, and optionally page-specific\n *\n * @example\n * ```ts\n * getPageTags()           // ['riverbank', 'riverbank:pages']\n * getPageTags('page-123') // ['riverbank', 'riverbank:pages', 'riverbank:page:page-123']\n * ```\n */\nexport function getPageTags(pageId?: string): string[] {\n  const tags = [RIVERBANK_GLOBAL_TAG, 'riverbank:pages'];\n  if (pageId) {\n    tags.push(`riverbank:page:${pageId}`);\n  }\n  return tags;\n}\n\n/**\n * Generate tags for content entries.\n *\n * @param contentTypeSlug - The content type slug (e.g., 'blog-post', 'event')\n * @param entryId - Optional specific entry ID to include\n * @returns Array of tags including global, content-type, and optionally entry-specific\n *\n * @example\n * ```ts\n * getEntryTags('blog-post')              // ['riverbank', 'riverbank:content-type:blog-post']\n * getEntryTags('blog-post', 'entry-456') // ['riverbank', 'riverbank:content-type:blog-post', 'riverbank:entry:entry-456']\n * ```\n */\nexport function getEntryTags(contentTypeSlug: string, entryId?: string): string[] {\n  const tags = [RIVERBANK_GLOBAL_TAG, `riverbank:content-type:${contentTypeSlug}`];\n  if (entryId) {\n    tags.push(`riverbank:entry:${entryId}`);\n  }\n  return tags;\n}\n\n/**\n * Generate tags for navigation menus.\n *\n * @param menuKey - Optional specific menu key to include\n * @returns Array of tags including global, navigation collection, and optionally menu-specific\n *\n * @example\n * ```ts\n * getNavigationTags()       // ['riverbank', 'riverbank:navigation']\n * getNavigationTags('main') // ['riverbank', 'riverbank:navigation', 'riverbank:navigation:main']\n * ```\n */\nexport function getNavigationTags(menuKey?: string): string[] {\n  const tags = [RIVERBANK_GLOBAL_TAG, 'riverbank:navigation'];\n  if (menuKey) {\n    tags.push(`riverbank:navigation:${menuKey}`);\n  }\n  return tags;\n}\n"],"mappings":";AA8BO,IAAM,uBAAuB;AAO7B,SAAS,cAAwB;AACtC,SAAO,CAAC,sBAAsB,gBAAgB;AAChD;AAcO,SAAS,YAAY,QAA2B;AACrD,QAAM,OAAO,CAAC,sBAAsB,iBAAiB;AACrD,MAAI,QAAQ;AACV,SAAK,KAAK,kBAAkB,MAAM,EAAE;AAAA,EACtC;AACA,SAAO;AACT;AAeO,SAAS,aAAa,iBAAyB,SAA4B;AAChF,QAAM,OAAO,CAAC,sBAAsB,0BAA0B,eAAe,EAAE;AAC/E,MAAI,SAAS;AACX,SAAK,KAAK,mBAAmB,OAAO,EAAE;AAAA,EACxC;AACA,SAAO;AACT;AAcO,SAAS,kBAAkB,SAA4B;AAC5D,QAAM,OAAO,CAAC,sBAAsB,sBAAsB;AAC1D,MAAI,SAAS;AACX,SAAK,KAAK,wBAAwB,OAAO,EAAE;AAAA,EAC7C;AACA,SAAO;AACT;","names":[]}