@se-studio/contentful-rest-api 0.0.0-next16-20260822103555

package/dist/revalidation/entry-handlers.js

@@ -0,0 +1,144 @@
+import { ArticleTag, ArticleTypeIndexTag, ArticleTypeTag, articleTag, articleTypeIndexTag, BannerTag, CustomTypeTag, DocumentTag, LinkTag, LocationTag, locationTag, NavigationItemTag, NavigationTag, PageTag, PageVariantTag, PersonTag, pageTag, pageVariantTag, personTag, RedirectTag, TagTag, TagTypeTag, TemplateTag, tagTag, tagTypeTag, templateTag, } from './tags.js';
+const defaultLocale = 'en-US';
+const articleTypeHandler = {
+    extract: (data) => ({
+        slug: data.fields?.slug?.[defaultLocale],
+    }),
+    makeTags: (extracted) => [extracted.slug ? articleTypeIndexTag(extracted.slug) : undefined],
+    getGlobalTags: () => [ArticleTypeTag, ArticleTypeIndexTag],
+    getCascadeTags: () => [ArticleTag],
+};
+function extractSlugWithPrevious(data) {
+    return {
+        slug: data.fields?.slug?.[defaultLocale],
+        previousSlug: data.previousFields?.slug?.[defaultLocale],
+    };
+}
+function slugChangeTags(extracted, tagFor) {
+    const tags = [extracted.slug ? tagFor(extracted.slug) : undefined];
+    if (extracted.previousSlug && extracted.previousSlug !== extracted.slug) {
+        tags.push(tagFor(extracted.previousSlug));
+    }
+    return tags;
+}
+const articleHandler = {
+    extract: extractSlugWithPrevious,
+    makeTags: (extracted) => slugChangeTags(extracted, articleTag),
+    getGlobalTags: () => [ArticleTag],
+    rebuildSearch: true,
+};
+const pageVariantHandler = {
+    extract: extractSlugWithPrevious,
+    makeTags: (extracted) => slugChangeTags(extracted, pageVariantTag),
+    getGlobalTags: () => [PageVariantTag],
+};
+const pageHandler = {
+    extract: extractSlugWithPrevious,
+    makeTags: (extracted) => slugChangeTags(extracted, pageTag),
+    getGlobalTags: () => [PageTag],
+};
+const templateHandler = {
+    extract: (data) => data.fields?.cmsLabel?.[defaultLocale],
+    makeTags: (extracted) => [extracted ? templateTag(extracted) : undefined],
+    getGlobalTags: () => [TemplateTag],
+    getCascadeTags: () => [PageTag, ArticleTag],
+};
+// biome-ignore lint/suspicious/noExplicitAny: handlers use heterogeneous extract shapes
+export const contentTypeHandlers = {
+    // biome-ignore lint/suspicious/noExplicitAny: page extract is SlugExtract
+    page: pageHandler,
+    // biome-ignore lint/suspicious/noExplicitAny: pageVariant extract is SlugExtract
+    pageVariant: pageVariantHandler,
+    // biome-ignore lint/suspicious/noExplicitAny: Any is ok for handlers with different types
+    article: articleHandler,
+    // biome-ignore lint/suspicious/noExplicitAny: Any is ok for handlers with different types
+    articleType: articleTypeHandler,
+    person: {
+        extract: (data) => data.fields?.slug?.[defaultLocale],
+        makeTags: (extracted) => [
+            extracted ? personTag(extracted) : undefined,
+        ],
+        getGlobalTags: () => [PersonTag],
+    },
+    tag: {
+        extract: (data) => data.fields?.slug?.[defaultLocale],
+        makeTags: (extracted) => [extracted ? tagTag(extracted) : undefined],
+        getGlobalTags: () => [TagTag],
+    },
+    tagType: {
+        extract: (data) => data.fields?.slug?.[defaultLocale],
+        makeTags: (extracted) => [
+            extracted ? tagTypeTag(extracted) : undefined,
+        ],
+        getGlobalTags: () => [TagTypeTag],
+    },
+    link: {
+        extract: () => undefined,
+        makeTags: () => undefined,
+        getGlobalTags: () => [LinkTag],
+    },
+    // biome-ignore lint/suspicious/noExplicitAny: Any is ok for handlers with different types
+    template: templateHandler,
+    customType: {
+        extract: () => undefined,
+        makeTags: () => undefined,
+        getGlobalTags: () => [CustomTypeTag],
+        getCascadeTags: () => [TagTag, PersonTag],
+    },
+    navigation: {
+        extract: () => undefined,
+        makeTags: () => undefined,
+        getGlobalTags: () => [NavigationTag],
+    },
+    navigationItem: {
+        extract: () => undefined,
+        makeTags: () => undefined,
+        getGlobalTags: () => [NavigationItemTag],
+    },
+    banner: {
+        extract: () => undefined,
+        makeTags: () => undefined,
+        getGlobalTags: () => [BannerTag],
+    },
+    document: {
+        extract: (data) => data.fields?.slug?.[defaultLocale],
+        makeTags: (extracted) => [
+            extracted ? `document#${extracted}` : undefined,
+        ],
+        getGlobalTags: () => [DocumentTag],
+    },
+    redirect: {
+        extract: () => undefined,
+        makeTags: () => undefined,
+        getGlobalTags: () => [RedirectTag],
+    },
+    location: {
+        extract: (data) => data.fields?.slug?.[defaultLocale],
+        makeTags: (extracted) => [
+            extracted ? locationTag(extracted) : undefined,
+        ],
+        getGlobalTags: () => [LocationTag],
+    },
+};
+/** Merge individual, collection, and coarse cascade tags for publish revalidation. */
+export function collectPublishTagsForHandler(
+// biome-ignore lint/suspicious/noExplicitAny: heterogeneous extract shapes across handlers
+handler, 
+// biome-ignore lint/suspicious/noExplicitAny: string | SlugExtract | objects
+extracted) {
+    const individual = handler
+        .makeTags(extracted)
+        ?.filter((tag) => tag !== undefined) ?? [];
+    const cascade = handler.getCascadeTags?.() ?? [];
+    return [...new Set([...individual, ...handler.getGlobalTags(), ...cascade])];
+}
+/** Tags revalidated when an entry is published (production mode). */
+export async function getPublishTagsForEntry(content) {
+    const contentType = content.sys.contentType.sys.id;
+    const handler = contentTypeHandlers[contentType];
+    if (!handler)
+        return [];
+    const extracted = await Promise.resolve(handler.extract(content));
+    return collectPublishTagsForHandler(handler, extracted);
+}
+//# sourceMappingURL=entry-handlers.js.map

package/dist/revalidation/entry-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-handlers.js","sourceRoot":"","sources":["../../src/revalidation/entry-handlers.ts"],"names":[],"mappings":"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"}

package/dist/revalidation/handlers.d.ts

@@ -0,0 +1,19 @@
+import type { BaseData, IContentTypeHandler } from './entry-handlers';
+export type { BaseData, IContentTypeHandler } from './entry-handlers';
+export { collectPublishTagsForHandler, contentTypeHandlers, getPublishTagsForEntry, } from './entry-handlers';
+export interface AssetData extends BaseData {
+    fields?: {
+        file?: {
+            [key: string]: {
+                url: string;
+                fileName: string;
+                contentType: string;
+            };
+        };
+    };
+}
+export declare function revalidateAsset(content: AssetData, message: string, preview?: boolean): Promise<boolean>;
+export declare function revalidateEntry(handler: IContentTypeHandler<BaseData, string | null | undefined>, content: BaseData, contentType: string, preview?: boolean): Promise<boolean>;
+export declare function revalidateDeletedEntry(contentType: string, preview?: boolean): Promise<boolean>;
+export declare function revalidateDeletedAsset(assetId: string, preview?: boolean): Promise<boolean>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/revalidation/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/revalidation/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAKtE,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE;YACL,CAAC,GAAG,EAAE,MAAM,GAAG;gBACb,GAAG,EAAE,MAAM,CAAC;gBACZ,QAAQ,EAAE,MAAM,CAAC;gBACjB,WAAW,EAAE,MAAM,CAAC;aACrB,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAID,wBAAsB,eAAe,CACnC,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CAclB;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EACjE,OAAO,EAAE,QAAQ,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/revalidation/handlers.js

@@ -0,0 +1,50 @@
+import { collectPublishTagsForHandler } from './entry-handlers.js';
+import { revalidateSingleTag, revalidateTags } from './server-utils.js';
+import { AssetTag, assetTag, GlobalTag } from './tags.js';
+export { collectPublishTagsForHandler, contentTypeHandlers, getPublishTagsForEntry, } from './entry-handlers.js';
+const defaultLocale = 'en-US';
+export async function revalidateAsset(content, message, preview = false) {
+    const id = content.sys.id;
+    const fileName = content.fields?.file?.[defaultLocale]?.fileName;
+    const tags = [assetTag(id), fileName ? assetTag(fileName) : undefined, AssetTag].filter((tag) => tag !== undefined);
+    if (preview) {
+        await revalidateSingleTag(GlobalTag, message);
+    }
+    else {
+        await revalidateTags(tags, message);
+    }
+    return true;
+}
+export async function revalidateEntry(handler, content, contentType, preview = false) {
+    const extracted = await Promise.resolve(handler.extract(content));
+    const tagsToRevalidate = collectPublishTagsForHandler(handler, extracted);
+    if (preview) {
+        await revalidateSingleTag(GlobalTag, `publish ${contentType} (preview mode)`);
+    }
+    else {
+        await revalidateTags(tagsToRevalidate, `publish ${contentType}`);
+    }
+    return true;
+}
+export async function revalidateDeletedEntry(contentType, preview = false) {
+    const { getCacheTagsForProduction } = await import('./utils.js');
+    const tags = getCacheTagsForProduction(contentType);
+    if (preview) {
+        await revalidateSingleTag(GlobalTag, `delete ${contentType} (preview mode)`);
+    }
+    else {
+        await revalidateTags(tags, `delete ${contentType}`);
+    }
+    return true;
+}
+export async function revalidateDeletedAsset(assetId, preview = false) {
+    const tags = [assetTag(assetId), AssetTag];
+    if (preview) {
+        await revalidateSingleTag(GlobalTag, `delete asset ${assetId} (preview mode)`);
+    }
+    else {
+        await revalidateTags(tags, `delete asset ${assetId}`);
+    }
+    return true;
+}
+//# sourceMappingURL=handlers.js.map

package/dist/revalidation/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/revalidation/handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGvD,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAc1B,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAkB,EAClB,OAAe,EACf,UAAmB,KAAK;IAExB,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC;IACjE,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,MAAM,CACrF,CAAC,GAAG,EAAiB,EAAE,CAAC,GAAG,KAAK,SAAS,CAC1C,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,MAAM,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAiE,EACjE,OAAiB,EACjB,WAAmB,EACnB,UAAmB,KAAK;IAExB,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAE1E,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,mBAAmB,CAAC,SAAS,EAAE,WAAW,WAAW,iBAAiB,CAAC,CAAC;IAChF,CAAC;SAAM,CAAC;QACN,MAAM,cAAc,CAAC,gBAAgB,EAAE,WAAW,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,UAAmB,KAAK;IAExB,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAEpD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,mBAAmB,CAAC,SAAS,EAAE,UAAU,WAAW,iBAAiB,CAAC,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,MAAM,cAAc,CAAC,IAAI,EAAE,UAAU,WAAW,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAe,EACf,UAAmB,KAAK;IAExB,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE3C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,OAAO,iBAAiB,CAAC,CAAC;IACjF,CAAC;SAAM,CAAC;QACN,MAAM,cAAc,CAAC,IAAI,EAAE,gBAAgB,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/revalidation/index.d.ts

@@ -0,0 +1,4 @@
+export * from './tags';
+export * from './utils';
+export * from './webhook-content-types';
+//# sourceMappingURL=index.d.ts.map

package/dist/revalidation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/revalidation/index.ts"],"names":[],"mappings":"AAEA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC"}

package/dist/revalidation/index.js

@@ -0,0 +1,5 @@
+// Revalidation utilities exports (Client-safe)
+export * from './tags.js';
+export * from './utils.js';
+export * from './webhook-content-types.js';
+//# sourceMappingURL=index.js.map

package/dist/revalidation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/revalidation/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC"}

package/dist/revalidation/nextjs-route.d.ts

@@ -0,0 +1,38 @@
+import { type NextRequest, NextResponse } from 'next/server';
+/**
+ * Configuration for the revalidation route
+ */
+export interface RevalidationConfig {
+    /** Secret for validating webhook requests */
+    secret?: string;
+    /** Whether to validate the secret */
+    validateSecret?: boolean;
+    /** Whether to run in preview mode (DRAFT_ONLY / always-preview deploys) */
+    preview?: boolean;
+    /**
+     * Site-only cache tags revalidated on REVALIDATE_ALL (after GlobalTag + AllTags).
+     * Prefer core AllTags for shared tags (e.g. hubspot-forms is already included).
+     */
+    extraTags?: string[];
+}
+/**
+ * Create a Next.js API route handler for Contentful revalidation
+ *
+ * @param config - Configuration options
+ * @returns Next.js POST handler function
+ *
+ * @example
+ * ```ts
+ * // In your app/api/revalidate/route.ts
+ * import { createRevalidationHandler } from '@se-studio/contentful-rest-api';
+ *
+ * export const POST = createRevalidationHandler({
+ *   secret: process.env.REVALIDATION_SECRET,
+ *   validateSecret: true,
+ *   preview: process.env.DRAFT_ONLY === 'true',
+ *   // extraTags: ['my-site-only-tag'],
+ * });
+ * ```
+ */
+export declare function createRevalidationHandler(config?: RevalidationConfig): (request: NextRequest) => Promise<NextResponse>;
+//# sourceMappingURL=nextjs-route.d.ts.map

package/dist/revalidation/nextjs-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-route.d.ts","sourceRoot":"","sources":["../../src/revalidation/nextjs-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,kBAAuB,GAC9B,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAejD"}

package/dist/revalidation/nextjs-route.js

@@ -0,0 +1,36 @@
+import { NextResponse } from 'next/server';
+import { handleRevalidation } from './route.js';
+/**
+ * Create a Next.js API route handler for Contentful revalidation
+ *
+ * @param config - Configuration options
+ * @returns Next.js POST handler function
+ *
+ * @example
+ * ```ts
+ * // In your app/api/revalidate/route.ts
+ * import { createRevalidationHandler } from '@se-studio/contentful-rest-api';
+ *
+ * export const POST = createRevalidationHandler({
+ *   secret: process.env.REVALIDATION_SECRET,
+ *   validateSecret: true,
+ *   preview: process.env.DRAFT_ONLY === 'true',
+ *   // extraTags: ['my-site-only-tag'],
+ * });
+ * ```
+ */
+export function createRevalidationHandler(config = {}) {
+    return async function POST(request) {
+        const { secret, validateSecret = true, preview = false, extraTags = [] } = config;
+        // Validate secret if required
+        if (validateSecret && secret) {
+            const requestSecret = request.headers.get('REVALIDATION_SECRET');
+            if (requestSecret !== secret) {
+                return NextResponse.json({ message: 'Invalid secret' }, { status: 401 });
+            }
+        }
+        // Handle the revalidation
+        return await handleRevalidation(request, preview, extraTags);
+    };
+}
+//# sourceMappingURL=nextjs-route.js.map

package/dist/revalidation/nextjs-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-route.js","sourceRoot":"","sources":["../../src/revalidation/nextjs-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAmB7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAA6B,EAAE;IAE/B,OAAO,KAAK,UAAU,IAAI,CAAC,OAAoB;QAC7C,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,OAAO,GAAG,KAAK,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;QAElF,8BAA8B;QAC9B,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;YAC7B,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACjE,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;gBAC7B,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,OAAO,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC"}

package/dist/revalidation/route.d.ts

@@ -0,0 +1,3 @@
+import { NextResponse } from 'next/server';
+export declare function handleRevalidation(request: Request, preview?: boolean, extraTags?: string[]): Promise<NextResponse>;
+//# sourceMappingURL=route.d.ts.map

package/dist/revalidation/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/revalidation/route.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiE3C,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,OAAe,EACxB,SAAS,GAAE,MAAM,EAAO,GACvB,OAAO,CAAC,YAAY,CAAC,CAgDvB"}

package/dist/revalidation/route.js

@@ -0,0 +1,99 @@
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { NextResponse } from 'next/server';
+import { contentTypeHandlers, revalidateAsset, revalidateDeletedAsset, revalidateDeletedEntry, revalidateEntry, } from './handlers.js';
+import { revalidateSingleTag } from './server-utils.js';
+import { collectRevalidateAllTags } from './tags.js';
+// Handle asset publishing
+async function publishAsset(content, preview) {
+    return await revalidateAsset(content, 'publish asset', preview);
+}
+// Handle asset deletion
+async function deleteAsset(content, preview) {
+    return await revalidateDeletedAsset(content.sys.id, preview);
+}
+// Handle entry publishing
+async function publishEntry(content, preview) {
+    const contentType = content.sys.contentType.sys.id;
+    const handler = contentTypeHandlers[contentType];
+    if (!handler) {
+        if (process.env.LOG_CMS)
+            console.warn(`Unknown content type: ${contentType}`);
+        return false;
+    }
+    return await revalidateEntry(handler, content, contentType, preview);
+}
+// Handle entry deletion
+async function deleteEntry(content, preview) {
+    if (process.env.LOG_CMS)
+        console.log(`Delete entry: ${content.sys.id}`);
+    const contentType = content.sys.contentType.sys.id;
+    const success = await revalidateDeletedEntry(contentType, preview);
+    // Note: Search rebuild logic would go here if needed
+    return success;
+}
+// Revalidate all tags (for global revalidation)
+async function revalidateAll(extraTags = []) {
+    if (process.env.LOG_CMS)
+        console.log('Revalidating all tags');
+    await delay(500);
+    // Always clear draft/preview Data Cache (`global`) and every collection tag,
+    // plus any site-only extras (deduped). Independent of preview flag so DRAFT_ONLY
+    // and production bulk revalidate the same known set.
+    for (const tag of collectRevalidateAllTags(extraTags)) {
+        await revalidateSingleTag(tag, 'global revalidation');
+    }
+    // Note: Search rebuild logic would go here if needed
+    return true;
+}
+// Utility delay function
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// Main revalidation handler function
+export async function handleRevalidation(request, preview = false, extraTags = []) {
+    try {
+        // Check for global revalidation header
+        const all = request.headers.get('REVALIDATE_ALL');
+        const single = request.headers.get('REVALIDATION_TAG');
+        if (all) {
+            const success = await revalidateAll(extraTags);
+            return NextResponse.json({ revalidated: success, now: Date.now() }, { status: 200 });
+        }
+        if (single) {
+            const success = await revalidateSingleTag(single, 'single tag revalidation');
+            return NextResponse.json({ revalidated: success, now: Date.now() }, { status: 200 });
+        }
+        // Parse webhook payload
+        const content = (await request.json());
+        let success = false;
+        switch (content.sys.type) {
+            case 'DeletedAsset':
+                success = await deleteAsset(content, preview);
+                break;
+            case 'DeletedEntry':
+                success = await deleteEntry(content, preview);
+                break;
+            case 'Asset':
+                success = await publishAsset(content, preview);
+                break;
+            case 'Entry':
+                success = await publishEntry(content, preview);
+                break;
+            default:
+                if (process.env.LOG_CMS)
+                    console.warn(`Unknown message type: ${content.sys.type}`);
+                return NextResponse.json({ message: 'Unknown message type' }, { status: 400 });
+        }
+        if (!success) {
+            return NextResponse.json({ message: 'Unknown content type' }, { status: 400 });
+        }
+        return NextResponse.json({ revalidated: success, now: Date.now() }, { status: 200 });
+    }
+    catch (error) {
+        console.error('Error in revalidation:', error);
+        // Send a 200 back as Contentful retries a few times!
+        return NextResponse.json({ message: 'Error in revalidation' }, { status: 500 });
+    }
+}
+//# sourceMappingURL=route.js.map

package/dist/revalidation/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/revalidation/route.ts"],"names":[],"mappings":"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"}

package/dist/revalidation/server-utils.d.ts

@@ -0,0 +1,31 @@
+import 'server-only';
+/**
+ * Immediate cache-tag expiry for Contentful webhooks.
+ *
+ * Next.js 16 requires a second argument. `'max'` is stale-while-revalidate and
+ * would leave published CMS content stale for the next visitor. `{ expire: 0 }`
+ * is the documented webhook/third-party path. Next 15.5 ignores the extra
+ * argument and keeps the previous immediate behaviour.
+ */
+export declare function revalidateCacheTag(tag: string): void;
+/**
+ * Revalidates multiple Next.js cache tags.
+ *
+ * Adds a delay between revalidations to prevent overwhelming the cache system.
+ * Use this when content changes affect multiple pages or entries.
+ *
+ * @param tags - Array of cache tags to revalidate
+ * @param reason - Reason for revalidation (for logging/debugging)
+ */
+export declare function revalidateTags(tags: string[], reason: string): Promise<void>;
+/**
+ * Revalidates a single Next.js cache tag.
+ *
+ * Adds a delay before revalidation to prevent overwhelming the cache system.
+ * Use this for targeted revalidation of specific content.
+ *
+ * @param tag - Cache tag to revalidate (e.g., 'page#home', 'article#my-post')
+ * @param reason - Reason for revalidation (for logging/debugging)
+ */
+export declare function revalidateSingleTag(tag: string, reason: string): Promise<void>;
+//# sourceMappingURL=server-utils.d.ts.map

package/dist/revalidation/server-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-utils.d.ts","sourceRoot":"","sources":["../../src/revalidation/server-utils.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAGrB;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF"}

package/dist/revalidation/server-utils.js

@@ -0,0 +1,54 @@
+import 'server-only';
+import { revalidateTag } from 'next/cache';
+/**
+ * Immediate cache-tag expiry for Contentful webhooks.
+ *
+ * Next.js 16 requires a second argument. `'max'` is stale-while-revalidate and
+ * would leave published CMS content stale for the next visitor. `{ expire: 0 }`
+ * is the documented webhook/third-party path. Next 15.5 ignores the extra
+ * argument and keeps the previous immediate behaviour.
+ */
+export function revalidateCacheTag(tag) {
+    revalidateTag(tag, { expire: 0 });
+}
+/**
+ * Revalidates multiple Next.js cache tags.
+ *
+ * Adds a delay between revalidations to prevent overwhelming the cache system.
+ * Use this when content changes affect multiple pages or entries.
+ *
+ * @param tags - Array of cache tags to revalidate
+ * @param reason - Reason for revalidation (for logging/debugging)
+ */
+export async function revalidateTags(tags, reason) {
+    // Add a delay to prevent overwhelming the cache system
+    await delay(500);
+    for (const tag of tags) {
+        if (process.env.LOG_CMS)
+            console.log(`Revalidating tag: ${tag} - ${reason}`);
+        revalidateCacheTag(tag);
+    }
+}
+/**
+ * Revalidates a single Next.js cache tag.
+ *
+ * Adds a delay before revalidation to prevent overwhelming the cache system.
+ * Use this for targeted revalidation of specific content.
+ *
+ * @param tag - Cache tag to revalidate (e.g., 'page#home', 'article#my-post')
+ * @param reason - Reason for revalidation (for logging/debugging)
+ */
+export async function revalidateSingleTag(tag, reason) {
+    await delay(500);
+    if (process.env.LOG_CMS)
+        console.log(`Revalidating single tag: ${tag} - ${reason}`);
+    revalidateCacheTag(tag);
+}
+/**
+ * Utility delay function
+ * @param ms - Milliseconds to delay
+ */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=server-utils.js.map

package/dist/revalidation/server-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-utils.js","sourceRoot":"","sources":["../../src/revalidation/server-utils.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,aAAa,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc,EAAE,MAAc;IACjE,uDAAuD;IACvD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,MAAM,MAAM,EAAE,CAAC,CAAC;QAC7E,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW,EAAE,MAAc;IACnE,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,GAAG,MAAM,MAAM,EAAE,CAAC,CAAC;IACpF,kBAAkB,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}