@riverbankcms/sdk 0.136.0 → 0.138.0

package/dist/server/index.mjs

@@ -65,7 +65,6 @@ const TAG_TEMPLATES = {
 	formSubmissionsBySlug: "riverbank:form-submissions:{slug}",
 	publicEvents: "riverbank:site:{siteId}:public-events",
 	publicEventFilters: "riverbank:site:{siteId}:public-event-filters",
-	publicWholeSeriesOfferings: "riverbank:site:{siteId}:public-whole-series-offerings",
 	publicTeamMembers: "riverbank:site:{siteId}:public-team-members",
 	publicProducts: "riverbank:site:{siteId}:public-products",
 	publicPasses: "riverbank:site:{siteId}:public-passes",
@@ -74,6 +73,7 @@ const TAG_TEMPLATES = {
 	publicShop: "riverbank:site:{siteId}:public-shop",
 	publicCheckout: "riverbank:site:{siteId}:public-checkout",
 	publicBookingServices: "riverbank:site:{siteId}:public-booking-services",
+	publicBookingAvailability: "riverbank:site:{siteId}:public-booking-availability",
 	siteNavigation: "riverbank:site:{siteId}:navigation",
 	navigationMenuById: "riverbank:navigation-menu:{menuId}",
 	navigationItemById: "riverbank:navigation-item:{itemId}",
@@ -1200,30 +1200,15 @@ const NEWSLETTER_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	}
 });
 //#endregion
-//#region ../api/src/publicWholeSeriesEndpointDefinitions.ts
-const PUBLIC_WHOLE_SERIES_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
-	listPublicWholeSeriesOfferings: {
-		path: "/public/sites/{siteId}/dated-offerings/whole-series",
+//#region ../api/src/publicEventEndpointDefinitions.ts
+const PUBLIC_EVENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	listPublicEventCalendarWindow: {
+		path: "/public/sites/{siteId}/events/calendar-window",
 		method: "GET",
-		revalidate: 60,
-		tags: [TAG_TEMPLATES.publicWholeSeriesOfferings],
-		errors: ["server:internal_error"],
+		revalidate: 0,
 		auth: "public",
 		responseKind: "json"
 	},
-	getPublicWholeSeriesOffering: {
-		path: "/public/sites/{siteId}/dated-offerings/whole-series/{eventSeriesId}",
-		method: "GET",
-		revalidate: 60,
-		tags: [TAG_TEMPLATES.publicWholeSeriesOfferings],
-		errors: ["resource:not_found", "server:internal_error"],
-		auth: "public",
-		responseKind: "json"
-	}
-});
-//#endregion
-//#region ../api/src/publicEventEndpointDefinitions.ts
-const PUBLIC_EVENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	resolvePublicEventCheckoutReturn: {
 		path: "/public/sites/{siteId}/events/checkout-return",
 		method: "POST",
@@ -1255,6 +1240,99 @@ const PUBLIC_EVENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	}
 });
 //#endregion
+//#region ../api/src/publicEventCheckoutEndpointDefinitions.ts
+/**
+* The public event registration/checkout endpoints, extracted from
+* `endpoints.ts`.
+*
+* They were moved out for the same reason the `sdkMedia*` block was: adding the
+* `errors` metadata `require-api-endpoint-errors` asks of a newly-added endpoint
+* pushed `endpoints.ts` past its `max-lines` baseline. The block is spread back
+* at the exact position it occupied, so `API_ENDPOINTS` key order is unchanged.
+* (The endpoint that originally motivated the move, `checkPublicEventEligibility`,
+* was since deleted on dev by #1326.)
+*/
+const PUBLIC_EVENT_CHECKOUT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	registerForEvent: {
+		path: "/public/sites/{siteId}/events/register",
+		method: "POST",
+		tags: [TAG_TEMPLATES.publicEvents, "event-registration"],
+		auth: "public",
+		responseKind: "json"
+	},
+	createPublicEventCheckout: {
+		path: "/public/sites/{siteId}/events/checkout",
+		method: "POST",
+		tags: [TAG_TEMPLATES.publicEvents, "event-checkout"],
+		auth: "public",
+		responseKind: "json"
+	}
+});
+//#endregion
+//#region ../api/src/publicBookingAvailabilityEndpointDefinitions.ts
+/**
+* Public appointment reads: the service catalogue and the bookable slot grid.
+*
+* These are the reads that appointment writes invalidate. They carry canonical
+* `riverbank:*` tags because the frontend revalidate endpoint discards anything
+* else, which is why the legacy `site-{siteId}` tag they used to declare could
+* never actually be cleared (issue 1364).
+*
+* Slot availability depends on both tags: the grid moves when a booking lands,
+* and again when the service definition behind it changes.
+*/
+const PUBLIC_BOOKING_AVAILABILITY_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	getPublicBookingServices: {
+		path: "/public/bookings/services",
+		method: "GET",
+		revalidate: 60,
+		tags: [TAG_TEMPLATES.publicBookingServices],
+		auth: "public",
+		responseKind: "json"
+	},
+	getPublicBookingService: {
+		path: "/public/bookings/services/{serviceId}",
+		method: "GET",
+		revalidate: 60,
+		tags: [TAG_TEMPLATES.publicBookingServices],
+		auth: "public",
+		responseKind: "json"
+	},
+	getPublicBookingResourcesReference: {
+		path: "/public/bookings/resources/reference",
+		method: "GET",
+		revalidate: 60,
+		tags: [TAG_TEMPLATES.publicBookingServices],
+		auth: "public",
+		responseKind: "json"
+	},
+	getPublicBookingAvailableDates: {
+		path: "/public/bookings/availability/dates",
+		method: "GET",
+		revalidate: 60,
+		tags: [TAG_TEMPLATES.publicBookingAvailability, TAG_TEMPLATES.publicBookingServices],
+		auth: "public",
+		responseKind: "json"
+	},
+	getPublicBookingAvailableSlots: {
+		path: "/public/bookings/availability/slots",
+		method: "GET",
+		revalidate: 60,
+		tags: [TAG_TEMPLATES.publicBookingAvailability, TAG_TEMPLATES.publicBookingServices],
+		auth: "public",
+		responseKind: "json"
+	},
+	getPublicWeeklySlotAvailability: {
+		path: "/public/bookings/weekly-slot-availability",
+		method: "GET",
+		revalidate: 60,
+		tags: [TAG_TEMPLATES.publicBookingAvailability, TAG_TEMPLATES.publicBookingServices],
+		auth: "public",
+		responseKind: "json",
+		errors: []
+	}
+});
+//#endregion
 //#region ../api/src/siteApiKeyEndpointDefinitions.ts
 const SITE_API_KEY_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	listSiteApiKeys: {
@@ -1615,6 +1693,88 @@ const SDK_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 		errors: ["validation:invalid_input", "server:internal_error"]
 	}
 });
+//#endregion
+//#region ../api/src/sdkMediaEndpointDefinitions.ts
+/** SDK media lookup, listing, deletion and upload endpoints (management-key authenticated). */
+const SDK_MEDIA_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	sdkMediaExists: {
+		path: "/sdk/{siteId}/media/exists",
+		method: "POST",
+		errors: ["validation:invalid_input"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkMediaFindByChecksum: {
+		path: "/sdk/{siteId}/media/find-by-checksum",
+		method: "POST",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkMediaResolve: {
+		path: "/sdk/{siteId}/media/resolve",
+		method: "POST",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkMediaList: {
+		path: "/sdk/{siteId}/media",
+		method: "GET",
+		auth: "service",
+		errors: [],
+		responseKind: "json"
+	},
+	sdkMediaDownload: {
+		path: "/sdk/{siteId}/media/{identifier}/download",
+		method: "GET",
+		auth: "service",
+		errors: [],
+		responseKind: "json"
+	},
+	sdkMediaDeletePreview: {
+		path: "/sdk/{siteId}/media/{identifier}/delete-preview",
+		method: "POST",
+		auth: "service",
+		errors: [],
+		responseKind: "json"
+	},
+	sdkMediaDeleteApply: {
+		path: "/sdk/{siteId}/media/{identifier}",
+		method: "DELETE",
+		auth: "service",
+		errors: [],
+		responseKind: "json"
+	},
+	sdkMediaUploadUrl: {
+		path: "/sdk/{siteId}/media/upload-url",
+		method: "POST",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"validation:payload_too_large",
+			"billing:plan_limit_exceeded",
+			"server:internal_error"
+		],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkMediaUploadFinalize: {
+		path: "/sdk/{siteId}/media/upload",
+		method: "POST",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"validation:payload_too_large",
+			"billing:plan_limit_exceeded",
+			"server:internal_error"
+		],
+		auth: "service",
+		responseKind: "json"
+	}
+});
 const API_ENDPOINTS$1 = {
 	...ACCOUNT_ENDPOINT_DEFINITIONS,
 	...PUBLIC_EVENT_ENDPOINT_DEFINITIONS,
@@ -3755,26 +3915,6 @@ const API_ENDPOINTS$1 = {
 		auth: "public",
 		responseKind: "json"
 	},
-	createTheme: {
-		path: "/ai/chat/create-theme",
-		method: "POST",
-		revalidate: 60,
-		tags: ["theme", "ai-theme"],
-		auth: "user",
-		responseKind: "json"
-	},
-	generateThemes: {
-		path: "/theme/generate",
-		method: "POST",
-		errors: [
-			"validation:invalid_input",
-			"resource:not_found",
-			"server:internal_error"
-		],
-		tags: ["theme"],
-		auth: "user",
-		responseKind: "json"
-	},
 	extractThemeFromInspiration: {
 		path: "/theme/extract-from-inspiration",
 		method: "POST",
@@ -3948,7 +4088,7 @@ const API_ENDPOINTS$1 = {
 		method: "DELETE",
 		tags: ["media", "media-{assetId}"],
 		auth: "user",
-		responseKind: "void"
+		responseKind: "json"
 	},
 	mediaBulkDelete: {
 		path: "/media/bulk-delete",
@@ -4506,55 +4646,7 @@ const API_ENDPOINTS$1 = {
 		auth: "public",
 		responseKind: "json"
 	},
-	getPublicBookingServices: {
-		path: "/public/bookings/services",
-		method: "GET",
-		revalidate: 60,
-		tags: ["site-{siteId}"],
-		auth: "public",
-		responseKind: "json"
-	},
-	getPublicBookingService: {
-		path: "/public/bookings/services/{serviceId}",
-		method: "GET",
-		revalidate: 60,
-		tags: ["site-{siteId}"],
-		auth: "public",
-		responseKind: "json"
-	},
-	getPublicBookingResourcesReference: {
-		path: "/public/bookings/resources/reference",
-		method: "GET",
-		revalidate: 60,
-		tags: ["site-{siteId}"],
-		auth: "public",
-		responseKind: "json"
-	},
-	getPublicBookingAvailableDates: {
-		path: "/public/bookings/availability/dates",
-		method: "GET",
-		revalidate: 300,
-		tags: ["site-{siteId}"],
-		auth: "public",
-		responseKind: "json"
-	},
-	getPublicBookingAvailableSlots: {
-		path: "/public/bookings/availability/slots",
-		method: "GET",
-		revalidate: 60,
-		tags: ["site-{siteId}"],
-		auth: "public",
-		responseKind: "json"
-	},
-	getPublicWeeklySlotAvailability: {
-		path: "/public/bookings/weekly-slot-availability",
-		method: "GET",
-		revalidate: 60,
-		tags: ["site-{siteId}"],
-		auth: "public",
-		responseKind: "json",
-		errors: []
-	},
+	...PUBLIC_BOOKING_AVAILABILITY_ENDPOINT_DEFINITIONS,
 	createPublicBookingAppointment: {
 		path: "/public/bookings/appointments",
 		method: "POST",
@@ -4844,7 +4936,6 @@ const API_ENDPOINTS$1 = {
 		auth: "public",
 		responseKind: "json"
 	},
-	...PUBLIC_WHOLE_SERIES_ENDPOINT_DEFINITIONS,
 	listPublicTeamMembers: {
 		path: "/public/sites/{siteId}/team-members",
 		method: "GET",
@@ -4857,11 +4948,7 @@ const API_ENDPOINTS$1 = {
 	resolveWaitlistClaim: {
 		path: "/public/sites/{siteId}/waitlists/claim/resolve",
 		method: "POST",
-		tags: [
-			TAG_TEMPLATES.publicWholeSeriesOfferings,
-			TAG_TEMPLATES.publicEvents,
-			"waitlist-claims"
-		],
+		tags: [TAG_TEMPLATES.publicEvents, "waitlist-claims"],
 		auth: "public",
 		responseKind: "json",
 		errors: [
@@ -4946,27 +5033,7 @@ const API_ENDPOINTS$1 = {
 		responseKind: "json",
 		errors: []
 	},
-	registerForEvent: {
-		path: "/public/sites/{siteId}/events/register",
-		method: "POST",
-		tags: [TAG_TEMPLATES.publicEvents, "event-registration"],
-		auth: "public",
-		responseKind: "json"
-	},
-	createPublicEventCheckout: {
-		path: "/public/sites/{siteId}/events/checkout",
-		method: "POST",
-		tags: [TAG_TEMPLATES.publicEvents, "event-checkout"],
-		auth: "public",
-		responseKind: "json"
-	},
-	checkPublicEventEligibility: {
-		path: "/public/sites/{siteId}/events/check-eligibility",
-		method: "POST",
-		tags: [TAG_TEMPLATES.publicEvents, "event-eligibility"],
-		auth: "public",
-		responseKind: "json"
-	},
+	...PUBLIC_EVENT_CHECKOUT_ENDPOINT_DEFINITIONS,
 	getPublicEventRegistrationStatus: {
 		path: "/public/sites/{siteId}/events/registration-status",
 		method: "GET",
@@ -6534,42 +6601,13 @@ const API_ENDPOINTS$1 = {
 		auth: "user",
 		responseKind: "json"
 	},
+	...SDK_MEDIA_ENDPOINT_DEFINITIONS,
 	sdkIdentifiersBackfill: {
 		path: "/sdk/{siteId}/identifiers/backfill",
 		method: "POST",
 		auth: "service",
 		responseKind: "json"
 	},
-	sdkMediaExists: {
-		path: "/sdk/{siteId}/media/exists",
-		method: "POST",
-		auth: "service",
-		responseKind: "json"
-	},
-	sdkMediaFindByChecksum: {
-		path: "/sdk/{siteId}/media/find-by-checksum",
-		method: "POST",
-		auth: "service",
-		responseKind: "json"
-	},
-	sdkMediaResolve: {
-		path: "/sdk/{siteId}/media/resolve",
-		method: "POST",
-		auth: "service",
-		responseKind: "json"
-	},
-	sdkMediaUploadUrl: {
-		path: "/sdk/{siteId}/media/upload-url",
-		method: "POST",
-		auth: "service",
-		responseKind: "json"
-	},
-	sdkMediaUploadFinalize: {
-		path: "/sdk/{siteId}/media/upload",
-		method: "POST",
-		auth: "service",
-		responseKind: "json"
-	},
 	sdkUpdateWorkflowRunStatus: {
 		path: "/sdk/{siteId}/workflows/runs/{runId}/status",
 		method: "POST",
@@ -8057,7 +8095,7 @@ var SimpleCache = class {
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.136.0";
+const SDK_VERSION = "0.138.0";
 //#endregion
 //#region src/client/error.ts
 let _Symbol$for;
@@ -8351,7 +8389,7 @@ const API_ENDPOINTS = Object.freeze({
 		path: "/public/bookings/services",
 		method: "GET",
 		revalidate: 60,
-		tags: ["site-{siteId}"],
+		tags: ["riverbank:site:{siteId}:public-booking-services"],
 		auth: "public",
 		responseKind: "json"
 	},
@@ -8359,7 +8397,7 @@ const API_ENDPOINTS = Object.freeze({
 		path: "/public/bookings/weekly-slot-availability",
 		method: "GET",
 		revalidate: 60,
-		tags: ["site-{siteId}"],
+		tags: ["riverbank:site:{siteId}:public-booking-availability", "riverbank:site:{siteId}:public-booking-services"],
 		auth: "public",
 		responseKind: "json"
 	},
@@ -8465,10 +8503,9 @@ const SUPPORTED_LOADER_ENDPOINTS = [
 	"listPublishedEntries",
 	"getPublishedEntryPreview",
 	"listPublicEvents",
+	"listPublicEventCalendarWindow",
 	"listPublicRecurringSchedule",
 	"getPublicEventDetails",
-	"listPublicWholeSeriesOfferings",
-	"getPublicWholeSeriesOffering",
 	"listPublicRouteCandidates",
 	"listPublicTeamMembers",
 	"listPublicProducts",
@@ -8490,6 +8527,10 @@ function isSupportedLoaderEndpoint(endpoint) {
 * live here must not be placed in a process-local or durable stale cache.
 */
 const PUBLIC_LOADER_CACHE_POLICIES = {
+	listPublicEventCalendarWindow: {
+		kind: "live",
+		reason: "booking_correctness"
+	},
 	listPublishedEntries: {
 		kind: "tagged",
 		tags: ["published_content"]
@@ -8510,14 +8551,6 @@ const PUBLIC_LOADER_CACHE_POLICIES = {
 		kind: "live",
 		reason: "booking_correctness"
 	},
-	listPublicWholeSeriesOfferings: {
-		kind: "tagged",
-		tags: ["public_whole_series_offerings"]
-	},
-	getPublicWholeSeriesOffering: {
-		kind: "tagged",
-		tags: ["public_whole_series_offerings"]
-	},
 	listPublicRouteCandidates: {
 		kind: "tagged",
 		tags: ["published_content"]
@@ -9036,27 +9069,19 @@ function createContentReadOperations(input) {
 	};
 }
 //#endregion
-//#region src/client/wholeSeriesReadOperations.ts
-function createWholeSeriesReadOperations(deps) {
-	return { async getPublicWholeSeriesOffering(params) {
-		const { siteId, eventSeriesId, stage, signal } = params;
-		if (!siteId) throw new Error("getPublicWholeSeriesOffering() requires siteId");
-		if (!eventSeriesId) throw new Error("getPublicWholeSeriesOffering() requires eventSeriesId");
-		const cacheKey = `public-whole-series-offering:${siteId}:${eventSeriesId}:${stage ?? ""}`;
-		return deps.resilientFetchData(cacheKey, (requestSignal) => deps.apiClient({
-			endpoint: "getPublicWholeSeriesOffering",
-			params: {
-				siteId,
-				eventSeriesId,
-				...stage && { stage }
-			},
-			options: { signal: requestSignal }
-		}), { signal });
-	} };
+//#region src/client/publicLoaderCacheAccess.ts
+function shouldWrite(cacheEnabled, force) {
+	return cacheEnabled && !force;
+}
+function liveLoaderOptions(endpoint, signal) {
+	return {
+		force: getPublicLoaderCachePolicy(endpoint).kind === "live",
+		signal
+	};
 }
 //#endregion
-//#region src/client/eventSubrouteReadOperations.ts
-function createEventSubrouteReadOperations(deps) {
+//#region src/client/publicEventReadOperations.ts
+function createPublicEventReadOperations(deps) {
 	async function resolveEventSubroute(params, kind) {
 		const { siteId, subject, segment, signal } = params;
 		if (!siteId || !segment) throw new Error(`${kind === "event-run" ? "resolveEventRun" : "resolveEventOccurrence"}() requires siteId, subject, and segment`);
@@ -9074,6 +9099,16 @@ function createEventSubrouteReadOperations(deps) {
 		}), { signal });
 	}
 	return {
+		async listPublicEventCalendarWindow({ signal, ...params }) {
+			return deps.resilientFetchData(`public-calendar-window:${JSON.stringify(params)}`, (requestSignal) => deps.apiClient({
+				endpoint: "listPublicEventCalendarWindow",
+				params: {
+					...params,
+					limit: params.limit === void 0 ? void 0 : String(params.limit)
+				},
+				options: { signal: requestSignal }
+			}), liveLoaderOptions("listPublicEventCalendarWindow", signal));
+		},
 		async resolveEventOccurrence(params) {
 			const response = await resolveEventSubroute(params, "event-occurrence");
 			return { occurrence: response.subroute?.kind === "event-occurrence" ? response.subroute.occurrence : null };
@@ -9381,17 +9416,6 @@ var CircuitOpenError = class extends Error {
 	}
 };
 //#endregion
-//#region src/client/publicLoaderCacheAccess.ts
-function shouldWrite(cacheEnabled, force) {
-	return cacheEnabled && !force;
-}
-function liveLoaderOptions(endpoint, signal) {
-	return {
-		force: getPublicLoaderCachePolicy(endpoint).kind === "live",
-		signal
-	};
-}
-//#endregion
 //#region src/client/index.ts
 let prebuildModule = null;
 function tryRequire(modulePath) {
@@ -9902,11 +9926,7 @@ function createRiverbankClientWithDeps(deps, config) {
 		resilientFetch,
 		prebuildLoader
 	});
-	const wholeSeriesReads = createWholeSeriesReadOperations({
-		apiClient,
-		resilientFetchData
-	});
-	const eventSubrouteReads = createEventSubrouteReadOperations({
+	const eventReads = createPublicEventReadOperations({
 		apiClient,
 		resilientFetchData
 	});
@@ -9943,7 +9963,6 @@ function createRiverbankClientWithDeps(deps, config) {
 		});
 	}
 	return {
-		...wholeSeriesReads,
 		async getSite(params) {
 			return (await contentReads.getSiteWithResilience(params)).data;
 		},
@@ -10192,7 +10211,7 @@ function createRiverbankClientWithDeps(deps, config) {
 				});
 			}, { signal });
 		},
-		...eventSubrouteReads,
+		...eventReads,
 		async checkRedirect(params) {
 			const { siteId, path, signal } = params;
 			if (!siteId || !path) throw new Error("checkRedirect() requires siteId and path");

package/dist/server/next/tags.mjs

@@ -1,11 +1,25 @@
-//#region src/next/tags.ts
+//#region ../api/src/cache-tags.ts
 /**
-* Canonical SDK-facing cache tag helpers.
+* Canonical cache tag catalog for Riverbank.
 *
-* Keep these SDK-owned so the package remains self-contained at the type
-* boundary, even though the dashboard/frontend use the same tag scheme.
+* Goal: eliminate ad-hoc tag strings and drift across apps/packages.
+*
+* Tag scheme: `riverbank:*`
+* - `riverbank` is the global tag (invalidate everything)
+* - Use `riverbank:<namespace>:...` for domain/resource tags
+*
+* Notes:
+* - This module is intentionally Next.js-independent.
+* - Apps can use these tags with Next's `revalidateTag()` and `unstable_cache`.
+* - Endpoint definitions in `packages/api/src/endpoints.ts` may use the template
+*   strings (with `{param}` placeholders) for fetch cache tagging.
 */
 const RIVERBANK_GLOBAL_TAG = "riverbank";
+/**
+* SDK-facing convenience helpers (kept for compatibility).
+* These intentionally do NOT include site scoping, because many SDK consumers
+* operate in a single-site context.
+*/
 function getSiteTags() {
 	return [RIVERBANK_GLOBAL_TAG, "riverbank:site"];
 }