@se-studio/contentful-rest-api 1.1.2 → 1.3.0

package/dist/utils/redirectMap.js

@@ -0,0 +1,39 @@
+/**
+ * Pure helper that turns a list of IRedirect (from Contentful) into the simple
+ * map used by middleware at runtime or baked into a static module at build.
+ *
+ * - Filters out inactive redirects.
+ * - Prefers explicit statusCode; defaults to 301.
+ * - Does light normalization (ensures leading /; the app's trailingSlash: true
+ *   convention means callers should store rules with trailing slashes for
+ *   internal paths).
+ *
+ * This is intentionally side-effect free and safe to run in a Next.js build
+ * script or edge middleware context.
+ */
+export function buildRedirectMap(redirects) {
+    const map = {};
+    if (!redirects || redirects.length === 0) {
+        return map;
+    }
+    for (const r of redirects) {
+        if (r.active === false)
+            continue;
+        let from = r.fromPath || '';
+        if (!from)
+            continue;
+        if (!from.startsWith('/'))
+            from = `/${from}`;
+        // Basic self-loop guard (don't bake a rule that points to itself)
+        const to = r.to || '';
+        if (!to)
+            continue;
+        if (to === from)
+            continue;
+        const status = (r.statusCode ?? 301);
+        // Last one wins if duplicates (editors should avoid); keeps it simple.
+        map[from] = { to, status };
+    }
+    return map;
+}
+//# sourceMappingURL=redirectMap.js.map

package/dist/utils/redirectMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirectMap.js","sourceRoot":"","sources":["../../src/utils/redirectMap.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAyC;IACxE,MAAM,GAAG,GAAgB,EAAE,CAAC;IAE5B,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK;YAAE,SAAS;QAEjC,IAAI,IAAI,GAAG,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAE7C,kEAAkE;QAClE,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,IAAI,EAAE,KAAK,IAAI;YAAE,SAAS;QAE1B,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAA+B,CAAC;QAEnE,uEAAuE;QACvE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/docs/llms.md

@@ -70,13 +70,19 @@ import { filterRelatedArticles } from '@se-studio/contentful-rest-api';
 
 const related = filterRelatedArticles(allArticleLinks, {
   tagIds: ['tag-entry-id-1', 'tag-entry-id-2'], // OR filter — must match at least one
-  articleTypeIds: ['article-type-id'],
+  tagSlugs: ['topic-a'],                        // slugs also supported (combined with OR)
+  articleTypeSlugs: ['resources/news'],         // or articleTypeIds
+  authorSlugs: ['alice'],                       // or authorIds
+  strictAuthorMatch: true,                      // hard filter (exclude non-matches) instead of boost
+  tagTypeSlugs: ['condition'],                  // hard filter on any tag's tagType
   excludeArticleIds: [currentArticle.id],
-  count: 3,
+  before: new Date('2025-01-01'),
+  count: 3,                                     // undefined = all matches after sort
+  allowUnindexed: true,
 });
 ```
 
-When `tagIds` is set, articles with no matching tag are excluded. Articles with more matching tags rank higher (then by date).
+When tag criteria are set, articles must match at least one (OR). More distinct matching tags → higher rank (then newest date). `strictAuthorMatch` turns author criteria into an exclude filter (key for person-scoped full lists). Use via `getAllArticleLinks({ articleTypeSlugs, strictAuthorMatch, ... })` in core-ui helpers for News Grids / Publications Lists without duplicating filter logic. Direct import is server-only (main barrel of the package pulls server-only transitive deps via enrichers).
 
 ## Sitemap Helpers
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/contentful-rest-api",
-  "version": "1.1.2",
+  "version": "1.3.0",
   "description": "Type-safe Contentful REST API client with caching and rate limiting for Next.js applications",
   "repository": {
     "type": "git",
@@ -51,7 +51,7 @@
     "@contentful/rich-text-types": "^17.2.7",
     "contentful": "^11.12.3",
     "server-only": "0.0.1",
-    "@se-studio/core-data-types": "1.1.2"
+    "@se-studio/core-data-types": "1.2.0"
   },
   "peerDependencies": {
     "next": ">=15.5.0"