@tdacorp/hyle-sdk 0.1.1 → 0.2.1

package/dist/next.js

@@ -2,18 +2,23 @@ import {
   ArticlePage,
   DocsPage,
   ListPage
-} from "./chunk-XODMIT6N.js";
+} from "./chunk-MHVWHSKC.js";
 import {
-  fetchResolver
-} from "./chunk-HVAWEEHG.js";
+  fetchResolver,
+  workspaceTags
+} from "./chunk-7VCMJUPC.js";
 import {
   Cp1ClientError,
-  createRevalidationCallbackRoute
-} from "./chunk-RI3BP4MI.js";
+  createRevalidationCallbackRoute,
+  listPublicationPaths
+} from "./chunk-HFUJRNFP.js";
 
 // src/next/page.tsx
 import { notFound, permanentRedirect, redirect } from "next/navigation";
 
+// src/next/options.ts
+import { unstable_rethrow } from "next/navigation";
+
 // src/next/paths.ts
 function normalizeBasePath(basePath) {
   const value = (basePath ?? "").replace(/\/+$/, "");
@@ -21,6 +26,7 @@ function normalizeBasePath(basePath) {
   if (!/^\/[^\s?#\\]+$/.test(value) || value.includes("//")) throw new TypeError(`basePath must look like "/learn", got "${basePath}"`);
   return value;
 }
+var MAX_PATH_LENGTH = 1024;
 function sitePathFrom(basePath, segments) {
   const decoded = [];
   for (const raw of segments ?? []) {
@@ -30,10 +36,12 @@ function sitePathFrom(basePath, segments) {
     } catch {
       return void 0;
     }
+    if (segment !== segment.normalize("NFC")) return void 0;
     if (segment === "" || segment === "." || segment === ".." || /[/\\\u0000-\u001f\u007f]/.test(segment)) return void 0;
     decoded.push(segment);
   }
-  return decoded.length === 0 ? basePath || "/" : `${basePath}/${decoded.join("/")}`;
+  const path = decoded.length === 0 ? basePath || "/" : `${basePath}/${decoded.join("/")}`;
+  return path.length > MAX_PATH_LENGTH ? void 0 : path;
 }
 function safeRedirectTarget(to) {
   if (typeof to !== "string" || !to.startsWith("/") || to.startsWith("//")) return void 0;
@@ -44,77 +52,135 @@ function safeRedirectTarget(to) {
 function resolverFor(options) {
   return options.resolver ?? fetchResolver(options);
 }
-var LOCALE_TAG = /^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8})*$/;
+var CURSOR = /^[A-Za-z0-9_-]{1,256}$/;
+var validCursor = (value) => typeof value === "string" && CURSOR.test(value) ? value : void 0;
+var LOCALE_TAG = /^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$/;
+var MAX_LOCALE_LENGTH = 35;
 function routeContext(options, params) {
   const basePath = normalizeBasePath(options.basePath);
   const segments = params[options.param ?? "hyle"];
   const path = sitePathFrom(basePath, typeof segments === "string" ? [segments] : segments);
   const given = typeof options.locale === "function" ? options.locale(params) : options.locale;
-  const locale = typeof given === "string" && LOCALE_TAG.test(given) ? given : void 0;
+  const locale = typeof given === "string" && given.length <= MAX_LOCALE_LENGTH && LOCALE_TAG.test(given) ? given : void 0;
   const prefix = options.localePrefix ?? (() => "");
   const toHref = (sitePath, linkLocale = locale) => (linkLocale ? prefix(linkLocale) : "") + sitePath;
   return { basePath, path, locale, toHref };
 }
+function isRejectedRequest(error) {
+  unstable_rethrow(error);
+  return error instanceof Cp1ClientError && error.status >= 400 && error.status < 500 && ![401, 403, 429].includes(error.status);
+}
 
 // src/next/page.tsx
 import { jsx } from "react/jsx-runtime";
 function hylePage(options) {
   const resolve = resolverFor(options);
-  return async function HylePage({ params }) {
+  return async function HylePage({ params, searchParams }) {
     const { path, locale, toHref } = routeContext(options, await params ?? {});
     if (path === void 0) notFound();
-    const result = await resolve(path, locale, options.listLimit);
-    switch (result.kind) {
-      case "article": {
-        const props = { article: result, components: options.components, slots: options.slots, locale, toHref };
-        return options.layout === "docs" ? /* @__PURE__ */ jsx(DocsPage, { ...props }) : /* @__PURE__ */ jsx(ArticlePage, { ...props });
-      }
-      case "list":
-        return /* @__PURE__ */ jsx(ListPage, { list: result, components: options.components, slots: options.slots, locale, toHref });
-      case "redirect": {
-        const to = safeRedirectTarget(result.to);
-        if (to === void 0) throw new Cp1ClientError("INVALID_RESPONSE", "hyle returned an unsafe redirect target", 502, "");
-        const target = safeRedirectTarget(toHref(to));
-        if (target === void 0) throw new Cp1ClientError("INVALID_RESPONSE", "hyle returned an unsafe redirect target", 502, "");
-        if (target === toHref(path)) notFound();
-        return result.status === 301 ? permanentRedirect(target) : redirect(target);
+    try {
+      const cursor = options.paginate === "searchParams" ? validCursor((await searchParams)?.cursor) : void 0;
+      const result = await resolve(path, locale, options.listLimit, cursor);
+      switch (result.kind) {
+        case "article": {
+          const props = { article: result, components: options.components, slots: options.slots, locale, toHref };
+          return options.layout === "docs" ? /* @__PURE__ */ jsx(DocsPage, { ...props }) : /* @__PURE__ */ jsx(ArticlePage, { ...props });
+        }
+        case "list": {
+          const list = options.list?.title ? { ...result, section: { ...result.section, title: options.list.title } } : result;
+          const next = options.paginate === "searchParams" ? validCursor(result.next_cursor) : void 0;
+          const olderHref = next ? `${toHref(path)}?cursor=${next}` : void 0;
+          return /* @__PURE__ */ jsx(ListPage, { list, ...olderHref ? { olderHref } : {}, ...options.list?.description ? { description: options.list.description } : {}, components: options.components, slots: options.slots, locale, toHref });
+        }
+        case "redirect": {
+          const to = safeRedirectTarget(result.to);
+          if (to === void 0) throw new Cp1ClientError("INVALID_RESPONSE", "hyle returned an unsafe redirect target", 502, "");
+          const target = safeRedirectTarget(toHref(to));
+          if (target === void 0) throw new Cp1ClientError("INVALID_RESPONSE", "hyle returned an unsafe redirect target", 502, "");
+          if (target === toHref(path)) notFound();
+          return result.status === 301 ? permanentRedirect(target) : redirect(target);
+        }
+        case "notfound":
+        case "disabled":
+          notFound();
       }
-      case "notfound":
-      case "disabled":
-        notFound();
+    } catch (error) {
+      if (isRejectedRequest(error)) notFound();
+      if (!options.onError) throw error;
+      console.error(`hyle: ${error instanceof Error ? error.name : "UnknownError"}`);
+      return options.onError(error);
     }
   };
 }
 
+// src/next/sitemap.ts
+var ISO_DATE = /^\d{4}-\d{2}-\d{2}T/;
+function httpsOrigin(origin) {
+  let url;
+  try {
+    url = new URL(origin);
+  } catch {
+    throw new TypeError("hyleSitemap: `origin` must be an https origin such as https://example.com");
+  }
+  if (url.protocol !== "https:" || url.origin !== origin.replace(/\/$/, "")) {
+    throw new TypeError("hyleSitemap: `origin` must be an https origin with no path, query or credentials");
+  }
+  return url.origin;
+}
+async function hyleSitemap(options) {
+  const origin = httpsOrigin(options.origin);
+  const resolve = resolverFor(options);
+  const locale = typeof options.locale === "string" ? options.locale : void 0;
+  const { basePath, toHref } = routeContext({ ...options, locale: () => locale }, {});
+  const client = { resolve: ({ path, locale: l, limit, cursor }) => resolve(path, l, limit, cursor) };
+  const { paths, complete } = await listPublicationPaths({ client, basePath, ...options.sections ? { sections: options.sections } : {}, ...locale ? { locale } : {} });
+  if (!complete && (options.onIncomplete === "throw" || options.onIncomplete === void 0 && paths.length === 0)) {
+    throw new Error("hyleSitemap: hyle could not be listed completely (see onIncomplete)");
+  }
+  return paths.map(({ path, publishedAt }) => ({
+    url: origin + encodeURI(toHref(path)),
+    ...ISO_DATE.test(publishedAt) && !Number.isNaN(Date.parse(publishedAt)) ? { lastModified: publishedAt } : {}
+  }));
+}
+
 // src/next/metadata.ts
 function hyleMetadata(options) {
   const resolve = resolverFor(options);
   return async function generateMetadata({ params }) {
     const { path, locale, toHref } = routeContext(options, await params ?? {});
     if (path === void 0) return {};
-    const result = await resolve(path, locale, options.listLimit);
-    if (result.kind === "list") return { title: result.section.title };
-    if (result.kind !== "article") return {};
-    const { publication: pub, alternates } = result;
-    const canonical = toHref(pub.canonical_path, pub.locale);
-    const description = pub.description ?? void 0;
-    return {
-      title: pub.title,
-      ...description ? { description } : {},
-      alternates: {
-        canonical,
-        ...alternates.length > 1 ? { languages: Object.fromEntries(alternates.map((a) => [a.locale, toHref(a.canonical_path, a.locale)])) } : {}
-      },
-      openGraph: {
-        type: "article",
+    try {
+      const result = await resolve(path, locale, options.listLimit);
+      if (result.kind === "list") {
+        const title = options.list?.title || result.section.title;
+        const description2 = options.list?.description;
+        return { title, ...description2 ? { description: description2 } : {}, openGraph: { title, ...description2 ? { description: description2 } : {} } };
+      }
+      if (result.kind !== "article") return {};
+      const { publication: pub, alternates } = result;
+      const canonical = toHref(pub.canonical_path, pub.locale);
+      const description = pub.description ?? void 0;
+      return {
         title: pub.title,
         ...description ? { description } : {},
-        url: canonical,
-        locale: pub.locale,
-        publishedTime: pub.published_at,
-        modifiedTime: pub.updated_at
-      }
-    };
+        alternates: {
+          canonical,
+          ...alternates.length > 1 ? { languages: Object.fromEntries(alternates.map((a) => [a.locale, toHref(a.canonical_path, a.locale)])) } : {}
+        },
+        openGraph: {
+          type: "article",
+          title: pub.title,
+          ...description ? { description } : {},
+          url: canonical,
+          locale: pub.locale,
+          publishedTime: pub.published_at,
+          modifiedTime: pub.updated_at
+        }
+      };
+    } catch (error) {
+      if (isRejectedRequest(error)) return {};
+      throw error;
+    }
   };
 }
 
@@ -140,6 +206,9 @@ function createRevalidateRoute(options) {
 }
 export {
   createRevalidateRoute,
+  fetchResolver,
   hyleMetadata,
-  hylePage
+  hylePage,
+  hyleSitemap,
+  workspaceTags
 };

package/dist/react.cjs

@@ -28,6 +28,7 @@ __export(react_exports, {
   NotFound: () => NotFound,
   Redirecting: () => Redirecting,
   TrustedServerHtml: () => TrustedServerHtml,
+  Unavailable: () => Unavailable,
   isSafeUrl: () => isSafeUrl,
   sanitizeHast: () => sanitizeHast,
   scopeId: () => scopeId,
@@ -280,7 +281,10 @@ var en = {
   rdBody: "You are being taken to its new address.",
   from: "From",
   to: "To",
-  rdFallback: "If nothing happens, go to the new address."
+  rdFallback: "If nothing happens, go to the new address.",
+  unKind: "Unavailable",
+  unTitle: "This page is temporarily unavailable",
+  unBody: "The content could not be loaded. Please try again in a moment."
 };
 var fr = {
   toc: "Sur cette page",
@@ -316,7 +320,10 @@ var fr = {
   rdBody: "Vous \xEAtes redirig\xE9 vers sa nouvelle adresse.",
   from: "De",
   to: "Vers",
-  rdFallback: "Si rien ne se passe, allez \xE0 la nouvelle adresse."
+  rdFallback: "Si rien ne se passe, allez \xE0 la nouvelle adresse.",
+  unKind: "Indisponible",
+  unTitle: "Cette page est momentan\xE9ment indisponible",
+  unBody: "Le contenu n'a pas pu \xEAtre charg\xE9. R\xE9essayez dans un instant."
 };
 var es = {
   toc: "En esta p\xE1gina",
@@ -352,7 +359,10 @@ var es = {
   rdBody: "Te estamos llevando a su nueva direcci\xF3n.",
   from: "Desde",
   to: "A",
-  rdFallback: "Si no pasa nada, ve a la nueva direcci\xF3n."
+  rdFallback: "Si no pasa nada, ve a la nueva direcci\xF3n.",
+  unKind: "No disponible",
+  unTitle: "Esta p\xE1gina no est\xE1 disponible por el momento",
+  unBody: "No se pudo cargar el contenido. Int\xE9ntalo de nuevo en un momento."
 };
 var TABLE = { en, fr, es };
 function stringsFor(locale) {
@@ -716,6 +726,14 @@ function NotFound({ path, homeHref = "/", ...base }) {
     ] })
   ] }) });
 }
+function Unavailable(base) {
+  const c = ctx(base, "en");
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Shell, { children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("section", { className: "hyle-state", "data-hyle-page": "unavailable", lang: c.locale, role: "status", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "kind", children: c.s.unKind }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("h1", { children: c.s.unTitle }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { children: c.s.unBody })
+  ] }) });
+}
 function Redirecting({ from, to, ...base }) {
   const c = ctx(base, "en");
   const { Link, s } = c;
@@ -748,6 +766,7 @@ function Redirecting({ from, to, ...base }) {
   NotFound,
   Redirecting,
   TrustedServerHtml,
+  Unavailable,
   isSafeUrl,
   sanitizeHast,
   scopeId,

package/dist/react.d.cts

@@ -62,6 +62,8 @@ interface NotFoundProps extends PageBaseProps {
     homeHref?: string;
 }
 declare function NotFound({ path, homeHref, ...base }: NotFoundProps): ReactElement;
+/** The fail-safe state `hylePage` renders when hyle cannot be reached. It takes no error: nothing internal can reach the markup. */
+declare function Unavailable(base: PageBaseProps): ReactElement;
 interface RedirectingProps extends PageBaseProps {
     from?: string;
     to: string;
@@ -108,9 +110,12 @@ declare const en: {
     from: string;
     to: string;
     rdFallback: string;
+    unKind: string;
+    unTitle: string;
+    unBody: string;
 };
 type Strings = typeof en;
 /** Strings for a BCP 47 tag; the primary subtag decides, anything unknown falls back to English. */
 declare function stringsFor(locale: string | undefined): Strings;
 
-export { ArticlePage, type ArticlePageProps, DocsPage, HastContent, type HastContentProps, HastLimitError, HyleComponents, ListPage, type ListPageProps, NotFound, type NotFoundProps, PageBaseProps, Redirecting, type RedirectingProps, type Strings, TrustedServerHtml, isSafeUrl, sanitizeHast, scopeId, stringsFor };
+export { ArticlePage, type ArticlePageProps, DocsPage, HastContent, type HastContentProps, HastLimitError, HyleComponents, ListPage, type ListPageProps, NotFound, type NotFoundProps, PageBaseProps, Redirecting, type RedirectingProps, type Strings, TrustedServerHtml, Unavailable, isSafeUrl, sanitizeHast, scopeId, stringsFor };

package/dist/react.d.ts

@@ -62,6 +62,8 @@ interface NotFoundProps extends PageBaseProps {
     homeHref?: string;
 }
 declare function NotFound({ path, homeHref, ...base }: NotFoundProps): ReactElement;
+/** The fail-safe state `hylePage` renders when hyle cannot be reached. It takes no error: nothing internal can reach the markup. */
+declare function Unavailable(base: PageBaseProps): ReactElement;
 interface RedirectingProps extends PageBaseProps {
     from?: string;
     to: string;
@@ -108,9 +110,12 @@ declare const en: {
     from: string;
     to: string;
     rdFallback: string;
+    unKind: string;
+    unTitle: string;
+    unBody: string;
 };
 type Strings = typeof en;
 /** Strings for a BCP 47 tag; the primary subtag decides, anything unknown falls back to English. */
 declare function stringsFor(locale: string | undefined): Strings;
 
-export { ArticlePage, type ArticlePageProps, DocsPage, HastContent, type HastContentProps, HastLimitError, HyleComponents, ListPage, type ListPageProps, NotFound, type NotFoundProps, PageBaseProps, Redirecting, type RedirectingProps, type Strings, TrustedServerHtml, isSafeUrl, sanitizeHast, scopeId, stringsFor };
+export { ArticlePage, type ArticlePageProps, DocsPage, HastContent, type HastContentProps, HastLimitError, HyleComponents, ListPage, type ListPageProps, NotFound, type NotFoundProps, PageBaseProps, Redirecting, type RedirectingProps, type Strings, TrustedServerHtml, Unavailable, isSafeUrl, sanitizeHast, scopeId, stringsFor };

package/dist/react.js

@@ -7,11 +7,12 @@ import {
   NotFound,
   Redirecting,
   TrustedServerHtml,
+  Unavailable,
   isSafeUrl,
   sanitizeHast,
   scopeId,
   stringsFor
-} from "./chunk-XODMIT6N.js";
+} from "./chunk-MHVWHSKC.js";
 export {
   ArticlePage,
   DocsPage,
@@ -21,6 +22,7 @@ export {
   NotFound,
   Redirecting,
   TrustedServerHtml,
+  Unavailable,
   isSafeUrl,
   sanitizeHast,
   scopeId,

package/dist/resolve-B_p0p4Zn.d.cts

@@ -0,0 +1,29 @@
+import { R as Resolved } from './types-DjXf6iPo.cjs';
+
+/** Resolves a site path to a result. The two built-in strategies are `fetchResolver` (default) and `cachedResolver` (`@tdacorp/hyle-sdk/next/use-cache`). */
+type HyleResolver = (path: string, locale: string | undefined, limit?: number, cursor?: string) => Promise<Resolved>;
+interface FetchResolverOptions {
+    readonly baseUrl: string;
+    readonly token: string;
+    /** The workspace id (HYLE_WORKSPACE_ID): the fetch is tagged before the response exists, so tags are built from it. */
+    readonly workspaceId: string;
+    /** Seconds before a cached page is revalidated in the background. Webhooks purge sooner. Default 300. */
+    readonly revalidate?: number;
+    /** Section slugs this mount can show besides the default "posts". Used only for tagging. */
+    readonly sections?: readonly string[];
+}
+/**
+ * The fetch cache tags for a workspace, in the contract's format (`hyle:1:ws:<id>`, `hyle:1:sec:<ws>:<section>`; docs/cp1-spec.md
+ * section 5.8). Tags known BEFORE the response, bounded however many URLs a visitor requests: the workspace tag, the default section
+ * and the configured `sections`. A publish, unpublish, rename or edit purges the section tag of the page's section, and the
+ * workspace tag covers section renames and the kill switch (docs/cp1-spec.md section 5.8), so a page refreshes without its
+ * own publication tag. A bad `workspaceId` or section slug throws a TypeError. A section not listed in `sections` falls back to `revalidate`, as does cross-section wikilink refresh.
+ */
+declare function workspaceTags(workspaceId: string, sections?: readonly string[]): string[];
+/**
+ * Next's fetch cache, tagged with `workspaceTags`: the default resolver of `hylePage`, exported to wrap (for example to adjust a
+ * result) or to reuse in a host's own routes. Works with no host configuration. Throws a TypeError without `workspaceId`.
+ */
+declare function fetchResolver(options: FetchResolverOptions): HyleResolver;
+
+export { type FetchResolverOptions as F, type HyleResolver as H, fetchResolver as f, workspaceTags as w };

package/dist/resolve-fMx2W8RR.d.ts

@@ -0,0 +1,29 @@
+import { R as Resolved } from './types-DjXf6iPo.js';
+
+/** Resolves a site path to a result. The two built-in strategies are `fetchResolver` (default) and `cachedResolver` (`@tdacorp/hyle-sdk/next/use-cache`). */
+type HyleResolver = (path: string, locale: string | undefined, limit?: number, cursor?: string) => Promise<Resolved>;
+interface FetchResolverOptions {
+    readonly baseUrl: string;
+    readonly token: string;
+    /** The workspace id (HYLE_WORKSPACE_ID): the fetch is tagged before the response exists, so tags are built from it. */
+    readonly workspaceId: string;
+    /** Seconds before a cached page is revalidated in the background. Webhooks purge sooner. Default 300. */
+    readonly revalidate?: number;
+    /** Section slugs this mount can show besides the default "posts". Used only for tagging. */
+    readonly sections?: readonly string[];
+}
+/**
+ * The fetch cache tags for a workspace, in the contract's format (`hyle:1:ws:<id>`, `hyle:1:sec:<ws>:<section>`; docs/cp1-spec.md
+ * section 5.8). Tags known BEFORE the response, bounded however many URLs a visitor requests: the workspace tag, the default section
+ * and the configured `sections`. A publish, unpublish, rename or edit purges the section tag of the page's section, and the
+ * workspace tag covers section renames and the kill switch (docs/cp1-spec.md section 5.8), so a page refreshes without its
+ * own publication tag. A bad `workspaceId` or section slug throws a TypeError. A section not listed in `sections` falls back to `revalidate`, as does cross-section wikilink refresh.
+ */
+declare function workspaceTags(workspaceId: string, sections?: readonly string[]): string[];
+/**
+ * Next's fetch cache, tagged with `workspaceTags`: the default resolver of `hylePage`, exported to wrap (for example to adjust a
+ * result) or to reuse in a host's own routes. Works with no host configuration. Throws a TypeError without `workspaceId`.
+ */
+declare function fetchResolver(options: FetchResolverOptions): HyleResolver;
+
+export { type FetchResolverOptions as F, type HyleResolver as H, fetchResolver as f, workspaceTags as w };

package/dist/use-cache.cjs

@@ -125,11 +125,11 @@ var MAX_TAGS = 128;
 var DISABLED_REVALIDATE = 30;
 var tokens = /* @__PURE__ */ new Map();
 var keyOf = (baseUrl, workspaceId) => `${baseUrl}\0${workspaceId}`;
-async function resolveCached(baseUrl, workspaceId, path, locale, limit, revalidate) {
+async function resolveCached(baseUrl, workspaceId, path, locale, limit, cursor, revalidate) {
   "use cache";
   const token = tokens.get(keyOf(baseUrl, workspaceId));
   if (!token) throw new Error("hyle: unknown cache configuration");
-  const result = await createHyleClient({ baseUrl, token }).resolve({ path, ...locale ? { locale } : {}, ...limit > 0 ? { limit } : {} });
+  const result = await createHyleClient({ baseUrl, token }).resolve({ path, ...locale ? { locale } : {}, ...limit > 0 ? { limit } : {}, ...cursor ? { cursor } : {} });
   if (result.kind !== "disabled") (0, import_cache.cacheTag)(...result.cache.tags.filter(isValidCacheTag).slice(0, MAX_TAGS));
   (0, import_cache.cacheLife)({ stale: 30, revalidate: result.kind === "disabled" ? Math.min(revalidate, DISABLED_REVALIDATE) : revalidate });
   return result;
@@ -137,7 +137,7 @@ async function resolveCached(baseUrl, workspaceId, path, locale, limit, revalida
 function cachedResolver(options) {
   tokens.set(keyOf(options.baseUrl, options.workspaceId), options.token);
   const revalidate = options.revalidate ?? DEFAULT_REVALIDATE;
-  return (path, locale, limit) => resolveCached(options.baseUrl, options.workspaceId, path, locale ?? "", limit ?? 0, revalidate);
+  return (path, locale, limit, cursor) => resolveCached(options.baseUrl, options.workspaceId, path, locale ?? "", limit ?? 0, cursor ?? "", revalidate);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/use-cache.d.cts

@@ -1,4 +1,4 @@
-import { H as HyleResolver } from './resolve-DrmTGaCr.cjs';
+import { H as HyleResolver } from './resolve-B_p0p4Zn.cjs';
 import './types-DjXf6iPo.cjs';
 
 /**

package/dist/use-cache.d.ts

@@ -1,4 +1,4 @@
-import { H as HyleResolver } from './resolve-Cz-3Q7T-.js';
+import { H as HyleResolver } from './resolve-fMx2W8RR.js';
 import './types-DjXf6iPo.js';
 
 /**

package/dist/use-cache.js

@@ -1,10 +1,10 @@
 import {
   DEFAULT_REVALIDATE
-} from "./chunk-HVAWEEHG.js";
+} from "./chunk-7VCMJUPC.js";
 import {
   createHyleClient,
   isValidCacheTag
-} from "./chunk-RI3BP4MI.js";
+} from "./chunk-HFUJRNFP.js";
 
 // src/next/use-cache.ts
 import { cacheLife, cacheTag } from "next/cache";
@@ -12,11 +12,11 @@ var MAX_TAGS = 128;
 var DISABLED_REVALIDATE = 30;
 var tokens = /* @__PURE__ */ new Map();
 var keyOf = (baseUrl, workspaceId) => `${baseUrl}\0${workspaceId}`;
-async function resolveCached(baseUrl, workspaceId, path, locale, limit, revalidate) {
+async function resolveCached(baseUrl, workspaceId, path, locale, limit, cursor, revalidate) {
   "use cache";
   const token = tokens.get(keyOf(baseUrl, workspaceId));
   if (!token) throw new Error("hyle: unknown cache configuration");
-  const result = await createHyleClient({ baseUrl, token }).resolve({ path, ...locale ? { locale } : {}, ...limit > 0 ? { limit } : {} });
+  const result = await createHyleClient({ baseUrl, token }).resolve({ path, ...locale ? { locale } : {}, ...limit > 0 ? { limit } : {}, ...cursor ? { cursor } : {} });
   if (result.kind !== "disabled") cacheTag(...result.cache.tags.filter(isValidCacheTag).slice(0, MAX_TAGS));
   cacheLife({ stale: 30, revalidate: result.kind === "disabled" ? Math.min(revalidate, DISABLED_REVALIDATE) : revalidate });
   return result;
@@ -24,7 +24,7 @@ async function resolveCached(baseUrl, workspaceId, path, locale, limit, revalida
 function cachedResolver(options) {
   tokens.set(keyOf(options.baseUrl, options.workspaceId), options.token);
   const revalidate = options.revalidate ?? DEFAULT_REVALIDATE;
-  return (path, locale, limit) => resolveCached(options.baseUrl, options.workspaceId, path, locale ?? "", limit ?? 0, revalidate);
+  return (path, locale, limit, cursor) => resolveCached(options.baseUrl, options.workspaceId, path, locale ?? "", limit ?? 0, cursor ?? "", revalidate);
 }
 export {
   cachedResolver

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdacorp/hyle-sdk",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "hyle SDK: a typed client for hyle's resolve endpoint, a hast renderer for React, and a Next.js catch-all page with tag-based revalidation.",
   "license": "MIT",
   "repository": {

package/dist/chunk-HVAWEEHG.js

@@ -1,29 +0,0 @@
-import {
-  createHyleClient,
-  isValidCacheTag
-} from "./chunk-RI3BP4MI.js";
-
-// src/next/resolve.ts
-var DEFAULT_REVALIDATE = 300;
-var MAX_TAGS = 64;
-function fetchTags(workspaceId, sections = []) {
-  const slugs = /* @__PURE__ */ new Set(["posts", ...sections]);
-  return [`hyle:1:ws:${workspaceId}`, ...[...slugs].map((s) => `hyle:1:sec:${workspaceId}:${s}`)].filter(isValidCacheTag).slice(0, MAX_TAGS);
-}
-function fetchResolver(options) {
-  if (!options.workspaceId) throw new TypeError("hylePage: `workspaceId` is required for the fetch cache (or pass a cachedResolver)");
-  const client = createHyleClient({ baseUrl: options.baseUrl, token: options.token });
-  const revalidate = options.revalidate ?? DEFAULT_REVALIDATE;
-  const tags = fetchTags(options.workspaceId, options.sections);
-  return (path, locale, limit) => client.resolve({
-    path,
-    ...locale !== void 0 ? { locale } : {},
-    ...limit !== void 0 ? { limit } : {},
-    init: { next: { revalidate, tags } }
-  });
-}
-
-export {
-  DEFAULT_REVALIDATE,
-  fetchResolver
-};

package/dist/resolve-Cz-3Q7T-.d.ts

@@ -1,16 +0,0 @@
-import { R as Resolved } from './types-DjXf6iPo.js';
-
-/** Resolves a site path to a result. The two built-in strategies are `fetchResolver` (default) and `cachedResolver` (`@tdacorp/hyle-sdk/next/use-cache`). */
-type HyleResolver = (path: string, locale: string | undefined, limit?: number) => Promise<Resolved>;
-interface FetchResolverOptions {
-    readonly baseUrl: string;
-    readonly token: string;
-    /** The workspace id (HYLE_WORKSPACE_ID): the fetch is tagged before the response exists, so tags are built from it. */
-    readonly workspaceId: string;
-    /** Seconds before a cached page is revalidated in the background. Webhooks purge sooner. Default 300. */
-    readonly revalidate?: number;
-    /** Section slugs this mount can show besides the default "posts". Used only for tagging. */
-    readonly sections?: readonly string[];
-}
-
-export type { FetchResolverOptions as F, HyleResolver as H };

package/dist/resolve-DrmTGaCr.d.cts

@@ -1,16 +0,0 @@
-import { R as Resolved } from './types-DjXf6iPo.cjs';
-
-/** Resolves a site path to a result. The two built-in strategies are `fetchResolver` (default) and `cachedResolver` (`@tdacorp/hyle-sdk/next/use-cache`). */
-type HyleResolver = (path: string, locale: string | undefined, limit?: number) => Promise<Resolved>;
-interface FetchResolverOptions {
-    readonly baseUrl: string;
-    readonly token: string;
-    /** The workspace id (HYLE_WORKSPACE_ID): the fetch is tagged before the response exists, so tags are built from it. */
-    readonly workspaceId: string;
-    /** Seconds before a cached page is revalidated in the background. Webhooks purge sooner. Default 300. */
-    readonly revalidate?: number;
-    /** Section slugs this mount can show besides the default "posts". Used only for tagging. */
-    readonly sections?: readonly string[];
-}
-
-export type { FetchResolverOptions as F, HyleResolver as H };