@se-studio/contentful-rest-api 1.12.0 → 1.14.0

package/dist/revalidation/handlers.js

@@ -1,102 +1,7 @@
 import { revalidateSingleTag, revalidateTags } from './server-utils.js';
-import { ArticleTag, ArticleTypeIndexTag, ArticleTypeTag, AssetTag, articleTag, articleTypeIndexTag, assetTag, BannerTag, CustomTypeTag, GlobalTag, LinkTag, LocationTag, locationTag, NavigationItemTag, NavigationTag, PageTag, PageVariantTag, PersonTag, pageTag, pageVariantTag, personTag, RedirectTag, TagTag, TagTypeTag, TemplateTag, tagTag, tagTypeTag, templateTag, } from './tags.js';
-// Default locale for Contentful
+import { AssetTag, assetTag, GlobalTag } from './tags.js';
+export { contentTypeHandlers, getPublishTagsForEntry } from './entry-handlers.js';
 const defaultLocale = 'en-US';
-// Content type handlers
-const articleTypeHandler = {
-    extract: (data) => ({
-        slug: data.fields?.slug?.[defaultLocale],
-    }),
-    makeTags: (extracted) => [extracted.slug ? articleTypeIndexTag(extracted.slug) : undefined],
-    getGlobalTags: () => [ArticleTypeTag, ArticleTypeIndexTag],
-};
-const articleHandler = {
-    extract: (data) => ({
-        slug: data.fields?.slug?.[defaultLocale],
-    }),
-    makeTags: (extracted) => [extracted?.slug ? articleTag(extracted.slug) : undefined],
-    getGlobalTags: () => [ArticleTag],
-    rebuildSearch: true,
-};
-const pageVariantHandler = {
-    extract: (data) => {
-        const pageVariantSlug = data.fields?.slug?.[defaultLocale];
-        return pageVariantSlug;
-    },
-    makeTags: (extracted) => [extracted ? pageVariantTag(extracted) : undefined],
-    getGlobalTags: () => [PageVariantTag],
-};
-const templateHandler = {
-    extract: (data) => data.fields?.cmsLabel?.[defaultLocale],
-    makeTags: (extracted) => [extracted ? templateTag(extracted) : undefined],
-    getGlobalTags: () => [TemplateTag],
-};
-// Content type handlers registry
-export const contentTypeHandlers = {
-    page: {
-        extract: (data) => data.fields?.slug?.[defaultLocale],
-        makeTags: (extracted) => [extracted ? pageTag(extracted) : undefined],
-        getGlobalTags: () => [PageTag],
-    },
-    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],
-    },
-    navigation: {
-        extract: () => undefined,
-        makeTags: () => undefined,
-        getGlobalTags: () => [NavigationTag],
-    },
-    navigationItem: {
-        extract: () => undefined,
-        makeTags: () => undefined,
-        getGlobalTags: () => [NavigationItemTag],
-    },
-    banner: {
-        extract: () => undefined,
-        makeTags: () => undefined,
-        getGlobalTags: () => [BannerTag],
-    },
-    redirect: {
-        extract: () => undefined,
-        makeTags: () => undefined,
-        getGlobalTags: () => [RedirectTag],
-    },
-    location: {
-        extract: (data) => data.fields?.slug?.[defaultLocale],
-        makeTags: (extracted) => [extracted ? locationTag(extracted) : undefined],
-        getGlobalTags: () => [LocationTag],
-    },
-};
-// Asset revalidation handler
 export async function revalidateAsset(content, message, preview = false) {
     const id = content.sys.id;
     const fileName = content.fields?.file?.[defaultLocale]?.fileName;
@@ -109,7 +14,6 @@ export async function revalidateAsset(content, message, preview = false) {
     }
     return true;
 }
-// Entry revalidation handler
 export async function revalidateEntry(handler, content, contentType, preview = false) {
     const extracted = await Promise.resolve(handler.extract(content));
     const tags = handler.makeTags(extracted);
@@ -124,7 +28,6 @@ export async function revalidateEntry(handler, content, contentType, preview = f
     }
     return true;
 }
-// Revalidate deleted entry by content type (collection tags only)
 export async function revalidateDeletedEntry(contentType, preview = false) {
     const { getCacheTagsForProduction } = await import('./utils.js');
     const tags = getCacheTagsForProduction(contentType);
@@ -136,7 +39,6 @@ export async function revalidateDeletedEntry(contentType, preview = false) {
     }
     return true;
 }
-// Revalidate deleted asset by ID
 export async function revalidateDeletedAsset(assetId, preview = false) {
     const tags = [assetTag(assetId), AssetTag];
     if (preview) {

package/dist/revalidation/handlers.js.map

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

package/dist/telemetry/deriveOperation.d.ts

@@ -0,0 +1,8 @@
+import type { CmsQueryContext } from './queryContext';
+/** Human-readable operation label for a Contentful content type. */
+export declare function operationLabel(contentType: string): string;
+/** Link-list fetch label with optional pagination suffix. */
+export declare function allLinksOperationLabel(contentType: string, page?: number): string;
+/** Fallback operation + identifier derived from a Contentful REST URL. */
+export declare function deriveOperationFromUrl(url: string): CmsQueryContext;
+//# sourceMappingURL=deriveOperation.d.ts.map

package/dist/telemetry/deriveOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveOperation.d.ts","sourceRoot":"","sources":["../../src/telemetry/deriveOperation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAmBtD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjF;AAeD,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAsBnE"}

package/dist/telemetry/deriveOperation.js

@@ -0,0 +1,59 @@
+const OPERATION_VERBS = {
+    page: 'Reading page',
+    pageVariant: 'Reading page variant',
+    article: 'Reading article',
+    articleType: 'Reading article type',
+    tag: 'Reading tag',
+    tagType: 'Reading tag type',
+    person: 'Reading person',
+    customType: 'Reading custom type',
+    template: 'Reading template',
+    banner: 'Reading banner',
+    redirect: 'Reading redirect',
+    navigation: 'Reading navigation',
+    navigationItem: 'Reading navigation item',
+    link: 'Reading link',
+};
+/** Human-readable operation label for a Contentful content type. */
+export function operationLabel(contentType) {
+    return OPERATION_VERBS[contentType] ?? `Reading ${contentType}`;
+}
+/** Link-list fetch label with optional pagination suffix. */
+export function allLinksOperationLabel(contentType, page) {
+    const base = `Reading all ${contentType} links`;
+    return page !== undefined && page > 1 ? `${base} (page ${page})` : base;
+}
+function slugFromSearchParams(params) {
+    const direct = params.get('fields.slug');
+    if (direct)
+        return direct;
+    for (const [key, value] of params.entries()) {
+        if (key.startsWith('fields.') && key.endsWith('.slug') && value) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/** Fallback operation + identifier derived from a Contentful REST URL. */
+export function deriveOperationFromUrl(url) {
+    try {
+        const parsed = new URL(url);
+        const assetMatch = parsed.pathname.match(/\/assets\/([^/]+)$/);
+        if (assetMatch?.[1]) {
+            return { operation: 'Reading asset', identifier: assetMatch[1] };
+        }
+        const contentType = parsed.searchParams.get('content_type');
+        const identifier = slugFromSearchParams(parsed.searchParams);
+        if (contentType) {
+            return {
+                operation: operationLabel(contentType),
+                ...(identifier ? { identifier } : {}),
+            };
+        }
+        return { operation: 'Reading Contentful' };
+    }
+    catch {
+        return { operation: 'Reading Contentful' };
+    }
+}
+//# sourceMappingURL=deriveOperation.js.map

package/dist/telemetry/deriveOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveOperation.js","sourceRoot":"","sources":["../../src/telemetry/deriveOperation.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAA2B;IAC9C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,sBAAsB;IACnC,OAAO,EAAE,iBAAiB;IAC1B,WAAW,EAAE,sBAAsB;IACnC,GAAG,EAAE,aAAa;IAClB,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,gBAAgB;IACxB,UAAU,EAAE,qBAAqB;IACjC,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,gBAAgB;IACxB,QAAQ,EAAE,kBAAkB;IAC5B,UAAU,EAAE,oBAAoB;IAChC,cAAc,EAAE,yBAAyB;IACzC,IAAI,EAAE,cAAc;CACrB,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,OAAO,eAAe,CAAC,WAAW,CAAC,IAAI,WAAW,WAAW,EAAE,CAAC;AAClE,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,IAAa;IACvE,MAAM,IAAI,GAAG,eAAe,WAAW,QAAQ,CAAC;IAChD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAuB;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;YAChE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC/D,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAE7D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO;gBACL,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC;gBACtC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtC,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/telemetry/queryContext.d.ts

@@ -0,0 +1,7 @@
+export interface CmsQueryContext {
+    operation: string;
+    identifier?: string;
+}
+export declare function withCmsQueryContext<T>(context: CmsQueryContext, fn: () => T): T;
+export declare function getCmsQueryContext(): CmsQueryContext | undefined;
+//# sourceMappingURL=queryContext.d.ts.map

package/dist/telemetry/queryContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryContext.d.ts","sourceRoot":"","sources":["../../src/telemetry/queryContext.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE/E;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAEhE"}

package/dist/telemetry/queryContext.js

@@ -0,0 +1,9 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const storage = new AsyncLocalStorage();
+export function withCmsQueryContext(context, fn) {
+    return storage.run(context, fn);
+}
+export function getCmsQueryContext() {
+    return storage.getStore();
+}
+//# sourceMappingURL=queryContext.js.map

package/dist/telemetry/queryContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryContext.js","sourceRoot":"","sources":["../../src/telemetry/queryContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAmB,CAAC;AAEzD,MAAM,UAAU,mBAAmB,CAAI,OAAwB,EAAE,EAAW;IAC1E,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/telemetry/queryLog.d.ts

@@ -0,0 +1,17 @@
+export interface CmsQueryLogEntry {
+    url: string;
+    operation: string;
+    identifier?: string;
+    bytes: number;
+    ms: number;
+}
+export declare function isCmsQueryLoggingEnabled(): boolean;
+/** Format byte count as a compact human-readable size (e.g. 23.5k, 1.2M). */
+export declare function formatPayloadSize(bytes: number): string;
+export declare function logCmsQuery(entry: Omit<CmsQueryLogEntry, 'operation' | 'identifier'> & Partial<Pick<CmsQueryLogEntry, 'operation' | 'identifier'>>): void;
+/** Read response body bytes and return text for JSON parsing. */
+export declare function readResponseBodyWithSize(response: Response): Promise<{
+    bytes: number;
+    text: string;
+}>;
+//# sourceMappingURL=queryLog.d.ts.map

package/dist/telemetry/queryLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryLog.d.ts","sourceRoot":"","sources":["../../src/telemetry/queryLog.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,YAAY,CAAC,GACvD,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC,GAC5D,IAAI,CAuBN;AAED,iEAAiE;AACjE,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAc1C"}

package/dist/telemetry/queryLog.js

@@ -0,0 +1,54 @@
+import { deriveOperationFromUrl } from './deriveOperation.js';
+import { getCmsQueryContext } from './queryContext.js';
+export function isCmsQueryLoggingEnabled() {
+    return process.env.LOG_CMS_QUERIES === '1';
+}
+/** Format byte count as a compact human-readable size (e.g. 23.5k, 1.2M). */
+export function formatPayloadSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}`;
+    if (bytes < 1024 * 1024) {
+        const kb = bytes / 1024;
+        return kb >= 100 ? `${Math.round(kb)}k` : `${kb.toFixed(1)}k`;
+    }
+    const mb = bytes / (1024 * 1024);
+    return mb >= 100 ? `${Math.round(mb)}M` : `${mb.toFixed(1)}M`;
+}
+export function logCmsQuery(entry) {
+    if (!isCmsQueryLoggingEnabled())
+        return;
+    const context = getCmsQueryContext();
+    const derived = deriveOperationFromUrl(entry.url);
+    const payload = {
+        url: entry.url,
+        operation: entry.operation ?? context?.operation ?? derived.operation,
+        ...(entry.identifier !== undefined
+            ? entry.identifier
+                ? { identifier: entry.identifier }
+                : {}
+            : context?.identifier
+                ? { identifier: context.identifier }
+                : derived.identifier
+                    ? { identifier: derived.identifier }
+                    : {}),
+        bytes: entry.bytes,
+        ms: entry.ms,
+    };
+    console.log(`[CMS query] ${JSON.stringify(payload)}`);
+}
+/** Read response body bytes and return text for JSON parsing. */
+export async function readResponseBodyWithSize(response) {
+    const contentLength = response.headers.get('content-length');
+    if (contentLength) {
+        const parsed = Number.parseInt(contentLength, 10);
+        const text = await response.text();
+        return {
+            bytes: Number.isNaN(parsed) ? Buffer.byteLength(text, 'utf8') : parsed,
+            text,
+        };
+    }
+    const buffer = await response.arrayBuffer();
+    const text = new TextDecoder().decode(buffer);
+    return { bytes: buffer.byteLength, text };
+}
+//# sourceMappingURL=queryLog.js.map

package/dist/telemetry/queryLog.js.map

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

package/docs/llms.md

@@ -304,6 +304,30 @@ import {
 } from '@se-studio/contentful-rest-api';
 ```
 
+## Query logging (dev)
+
+Set `LOG_CMS_QUERIES=1` to emit structured per-fetch lines:
+
+```
+[CMS query] {"url":"...","operation":"Reading article","identifier":"my-slug","bytes":24064,"ms":45}
+```
+
+Merge with Next.js dev fetch cache lines (`(cache hit|miss)`) after the fact:
+
+```bash
+pnpm dev 2>&1 | tee dev.log
+pnpm --filter @se-studio/contentful-rest-api consolidate-cms-logs -- dev.log
+# => Reading article my-slug - 23.5k (cached) in 12ms
+```
+
+For reliable URL matching, enable full fetch URLs in the app's `next.config.js`:
+
+```js
+logging: { fetches: { fullUrl: true } }
+```
+
+Related: `LOG_CMS=1` (conversion warnings), `LOG_CMS_FETCH=1` (raw URLs only).
+
 ## Important Constraints
 
 - Always supply `spaceId`, `accessToken`, and `environment`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/contentful-rest-api",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "Type-safe Contentful REST API client with caching and rate limiting for Next.js applications",
   "repository": {
     "type": "git",
@@ -61,7 +61,7 @@
     "@contentful/rich-text-types": "^17.2.7",
     "contentful": "^11.12.5",
     "server-only": "0.0.1",
-    "@se-studio/core-data-types": "1.5.1"
+    "@se-studio/core-data-types": "1.6.0"
   },
   "peerDependencies": {
     "next": ">=15.5.0 <16"
@@ -78,7 +78,8 @@
     "dev": "tsc --project tsconfig.build.json --watch",
     "type-check": "tsc --noEmit",
     "lint": "biome lint .",
-    "test": "vitest run",
+    "test": "vitest run && node --test scripts/cms-query-log-consolidate.test.mjs",
+    "consolidate-cms-logs": "node scripts/consolidate-cms-query-logs.mjs",
     "clean": "rm -rf dist .turbo *.tsbuildinfo",
     "extract-single-page": "bash -c 'set -a && source ../../.env.local && set +a && tsx scripts/extract-page.ts \"$@\"' --",
     "extract-single-article": "bash -c 'set -a && source ../../.env.local && set +a && tsx scripts/extract-article.ts \"$@\"' --"