@andesine/pages 0.0.0-stage → 0.6.0

package/dist/chunks/index-D8wL2B5s.d.ts

@@ -0,0 +1,571 @@
+import { z } from "zod";
+import { Root } from "hast";
+//#region src/config/schema.d.ts
+declare const linkSchema: z.ZodObject<{
+  label: z.ZodString;
+  href: z.ZodString;
+  icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const pageActionsSchema: z.ZodObject<{
+  openIn: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+    chatgpt: "chatgpt";
+    claude: "claude";
+    perplexity: "perplexity";
+  }>>>;
+}, z.core.$strict>;
+declare const configSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  site: z.ZodURL;
+  base: z.ZodDefault<z.ZodString>;
+  language: z.ZodDefault<z.ZodString>;
+  logo: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<{
+      icon: "icon";
+      full: "full";
+    }>>;
+    alt: z.ZodOptional<z.ZodString>;
+    title: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
+  favicon: z.ZodOptional<z.ZodString>;
+  brand: z.ZodPrefault<z.ZodObject<{
+    primary: z.ZodDefault<z.ZodString>;
+    secondary: z.ZodDefault<z.ZodString>;
+    tertiary: z.ZodDefault<z.ZodString>;
+  }, z.core.$strict>>;
+  links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+    icon: z.ZodString;
+  }, z.core.$strict>>>;
+  cta: z.ZodOptional<z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  socialLinks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+    icon: z.ZodString;
+  }, z.core.$strict>>>;
+  sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    sources: z.ZodArray<z.ZodString>;
+    links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      href: z.ZodString;
+      icon: z.ZodString;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>>;
+  sectionsDisplay: z.ZodDefault<z.ZodEnum<{
+    tabs: "tabs";
+    navigation: "navigation";
+  }>>;
+  sources: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"files">;
+    directory: z.ZodString;
+    mount: z.ZodDefault<z.ZodString>;
+  }, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"andesine">;
+    collection: z.ZodString;
+    mount: z.ZodDefault<z.ZodString>;
+    apiURL: z.ZodOptional<z.ZodURL>;
+    apiKeyEnv: z.ZodDefault<z.ZodString>;
+    answers: z.ZodDefault<z.ZodBoolean>;
+    publicKey: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"openapi">;
+    spec: z.ZodString;
+    mount: z.ZodDefault<z.ZodString>;
+    tagPages: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>], "type">>>;
+  pageActions: z.ZodPrefault<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+    openIn: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+      chatgpt: "chatgpt";
+      claude: "claude";
+      perplexity: "perplexity";
+    }>>>;
+  }, z.core.$strict>]>>;
+  agents: z.ZodPrefault<z.ZodObject<{
+    instructions: z.ZodOptional<z.ZodString>;
+    skill: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  social: z.ZodPrefault<z.ZodObject<{
+    image: z.ZodOptional<z.ZodString>;
+    generate: z.ZodDefault<z.ZodBoolean>;
+    background: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+}, z.core.$strict>;
+type PagesConfigInput = z.input<typeof configSchema>;
+type PagesConfig = z.output<typeof configSchema>;
+type SourceConfig = PagesConfig["sources"][number];
+type FilesSourceConfig = Extract<SourceConfig, {
+  type: "files";
+}>;
+type AndesineSourceConfig = Extract<SourceConfig, {
+  type: "andesine";
+}>;
+type OpenAPISourceConfig = Extract<SourceConfig, {
+  type: "openapi";
+}>;
+type SectionConfig = PagesConfig["sections"][number];
+type LinkConfig = z.output<typeof linkSchema>;
+type IconLinkConfig = PagesConfig["links"][number];
+type AIService = z.output<typeof pageActionsSchema>["openIn"][number];
+//#endregion
+//#region src/config/index.d.ts
+declare const parseConfig: (input: unknown, source?: string) => PagesConfig;
+declare const defineConfig: (input: PagesConfigInput) => PagesConfig;
+//#endregion
+//#region src/context/types.d.ts
+interface SiteLogo {
+  src: string;
+  /** A square mark next to the site name, or a full wordmark before it. */
+  format: "icon" | "full";
+  /** The text in a full logo, for screen readers. */
+  alt?: string;
+  /** Shows the site name after the logo. */
+  title: boolean;
+}
+/** Direct access to the Andesine API with a publishable key, in place of the server routes. */
+interface AndesineAPIContext {
+  /** Base URL of the API. */
+  url: string;
+  /** The publishable key; it is safe in browsers. */
+  key: string;
+  /** ID of the published collection. */
+  collection: string;
+  /** Base-prefixed URL of the JSON map from entry IDs to page URLs. */
+  pages: string;
+}
+interface SearchSourceContext {
+  id: string;
+  /** Group label in results: the section label, or the site name. */
+  label: string;
+  /** Pagefind for local pages, or the Andesine search endpoint. */
+  type: "pagefind" | "andesine";
+  /** Set when the source has a publishable key; the browser then calls the API. */
+  api?: AndesineAPIContext;
+}
+interface AnswersContext {
+  endpoint: string;
+  /** ID of the source that answers questions. */
+  source: string;
+  /** Set when the source has a publishable key; the browser then calls the API. */
+  api?: AndesineAPIContext;
+}
+interface SearchContext {
+  sources: SearchSourceContext[];
+  endpoint: string;
+  /** Base-prefixed URL of the Pagefind directory. */
+  pagefind: string;
+  /** Undefined when no Andesine source has AI answers. */
+  answers?: AnswersContext;
+}
+interface SiteContext {
+  name: string;
+  description?: string;
+  language: string;
+  /** Base-prefixed URL of the home page. */
+  href: string;
+  /** Absolute URL of the home page. */
+  url: string;
+  /** A prefix for browser storage keys, unique for each site. */
+  storageKey: string;
+  logo?: SiteLogo;
+  favicon?: string;
+  /** Where sections show: tabs in the header, or links at the top of the navigation. */
+  sectionsDisplay: "tabs" | "navigation";
+  links: IconLinkConfig[];
+  cta?: LinkConfig;
+  socialLinks: IconLinkConfig[];
+  /** Undefined when no source is searchable. */
+  search?: SearchContext;
+}
+interface SectionContext {
+  id: string;
+  label: string;
+  icon?: string;
+  href: string;
+  current: boolean;
+}
+interface NavigationItem {
+  id: string;
+  label: string;
+  /** Groups without a landing page have no URL. */
+  href?: string;
+  /** The HTTP method of an API operation, e.g. `get`. */
+  method?: string;
+  current: boolean;
+  /** The item contains the current page. */
+  active: boolean;
+  children: NavigationItem[];
+}
+interface BreadcrumbItem {
+  label: string;
+  href?: string;
+}
+interface HeadingContext {
+  id: string;
+  text: string;
+  depth: number;
+}
+interface PageLink {
+  label: string;
+  href: string;
+}
+interface PageMeta {
+  /** The document title: the page title, then the site name. */
+  title: string;
+  /** The page description, or else the site description. */
+  description?: string;
+  /** The Open Graph type: `website` for the home page, `article` for other pages. */
+  type: "website" | "article";
+}
+interface PageFragments {
+  /** The page has a `summary` slot with content. */
+  summary: boolean;
+  /** The page has an `aside` slot with content. */
+  aside: boolean;
+}
+interface SocialImage {
+  /** Absolute URL of the image. */
+  url: string;
+  /** Known for generated images. */
+  width?: number;
+  height?: number;
+}
+interface OpenInLink {
+  id: AIService;
+  label: string;
+  /** Opens the service with the page's Markdown alternative as context. */
+  href: string;
+}
+interface PageActionsContext {
+  openIn: OpenInLink[];
+}
+interface PageContext {
+  site: SiteContext;
+  title: string;
+  description?: string;
+  meta: PageMeta;
+  fragments: PageFragments;
+  /** `reference` fills the content area on wide screens, for API operations and their examples. */
+  layout: "docs" | "wide" | "reference";
+  sections: SectionContext[];
+  /** Links at the top of the navigation: the site's links, then the current section's. */
+  links: IconLinkConfig[];
+  navigation: NavigationItem[];
+  /** The groups that contain the page, from the section root. */
+  breadcrumbs: BreadcrumbItem[];
+  headings: HeadingContext[];
+  previous?: PageLink;
+  next?: PageLink;
+  /** Absolute URL of the page; undefined for the not-found page. */
+  canonical?: string;
+  /** URL of the page's Markdown alternative; undefined for the not-found page. */
+  markdown?: string;
+  /** Undefined when page actions are off, or for the not-found page. */
+  actions?: PageActionsContext;
+  /** ISO date of the last content change, when known. */
+  updatedAt?: string;
+  /** Search engines must not index the page: it is hidden from search, or not found. */
+  noindex?: boolean;
+  /** schema.org JSON-LD, safe to put in a `<script type="application/ld+json">`. */
+  structuredData?: string;
+  /** The image for link previews: generated for the page, or the configured default. */
+  image?: SocialImage;
+}
+//#endregion
+//#region src/context/site.d.ts
+declare const createSiteContext: (config: PagesConfig) => SiteContext;
+//#endregion
+//#region src/sources/openapi/model.d.ts
+interface ApiModel {
+  title: string;
+  version: string;
+  /** Markdown. */
+  description?: string;
+  servers: ApiServer[];
+  securitySchemes: ApiSecurityScheme[];
+  /** Tags in the order of the spec's `tags`, then in order of first use. */
+  tags: ApiTag[];
+  operations: ApiOperation[];
+  /** Named schemas, which `ApiSchema.ref` points to. */
+  schemas: Record<string, ApiSchema>;
+}
+interface ApiServer {
+  /** Absolute URL with server variables resolved. */
+  url: string;
+  description?: string;
+}
+interface ApiSecurityScheme {
+  id: string;
+  type: string;
+  /** Markdown. */
+  description?: string;
+  /** For `http` schemes, e.g. `bearer`. */
+  scheme?: string;
+  bearerFormat?: string;
+  /** For `apiKey` schemes: the name and place of the key. */
+  name?: string;
+  in?: string;
+}
+interface ApiTag {
+  name: string;
+  label: string;
+  /** Markdown. */
+  description?: string;
+}
+interface ApiOperation {
+  /** The `operationId`, or `{method}-{path}` without one. */
+  id: string;
+  method: string;
+  path: string;
+  summary?: string;
+  /** Markdown. */
+  description?: string;
+  deprecated: boolean;
+  tags: string[];
+  parameters: ApiParameter[];
+  requestBody?: ApiRequestBody;
+  responses: ApiResponse[];
+  /** Alternative requirements; each maps scheme IDs to scopes. Empty means no authentication. */
+  security: Array<Record<string, string[]>>;
+  servers: ApiServer[];
+  /** From `x-codeSamples` or `x-code-samples`. */
+  codeSamples: ApiCodeSample[];
+  /** The `x-` fields of the operation. */
+  extensions: Record<string, unknown>;
+}
+interface ApiParameter {
+  name: string;
+  in: "path" | "query" | "header" | "cookie";
+  required: boolean;
+  deprecated: boolean;
+  /** Markdown. */
+  description?: string;
+  schema?: ApiSchema;
+  examples: ApiExample[];
+  /** The media type of a parameter with `content`, whose values are written in that type. */
+  mediaType?: string;
+  /** How values are written, e.g. `form` or `deepObject`; unset for the default of the place. */
+  style?: string;
+  explode?: boolean;
+}
+interface ApiRequestBody {
+  required: boolean;
+  /** Markdown. */
+  description?: string;
+  contents: ApiMediaType[];
+}
+interface ApiResponse {
+  /** A status code, a range such as `4XX`, or `default`. */
+  status: string;
+  /** Markdown. */
+  description?: string;
+  headers: ApiHeader[];
+  contents: ApiMediaType[];
+}
+interface ApiHeader {
+  name: string;
+  required: boolean;
+  /** Markdown. */
+  description?: string;
+  schema?: ApiSchema;
+}
+interface ApiMediaType {
+  type: string;
+  schema?: ApiSchema;
+  examples: ApiExample[];
+  encoding?: Record<string, ApiEncoding>;
+}
+interface ApiEncoding {
+  contentType?: string;
+  style?: string;
+  explode?: boolean;
+}
+interface ApiExample {
+  name?: string;
+  summary?: string;
+  value: unknown;
+}
+interface ApiCodeSample {
+  lang: string;
+  label: string;
+  source: string;
+}
+/** A JSON Schema with 3.0 and 3.1 differences removed, e.g. `nullable` is a `null` type. */
+interface ApiSchema {
+  /**
+   * The name of a schema in `ApiModel.schemas`. Only annotations can be set with it: the
+   * description, default, examples, and the deprecated, read-only, and write-only flags.
+   */
+  ref?: string;
+  type?: string[];
+  format?: string;
+  /** OpenAPI 3.1 content of a string, e.g. `image/png` for a file. */
+  contentMediaType?: string;
+  contentEncoding?: string;
+  title?: string;
+  /** Markdown. */
+  description?: string;
+  enum?: unknown[];
+  const?: unknown;
+  default?: unknown;
+  examples?: unknown[];
+  deprecated?: boolean;
+  readOnly?: boolean;
+  writeOnly?: boolean;
+  required?: string[];
+  properties?: ApiProperty[];
+  additionalProperties?: ApiSchema | boolean;
+  items?: ApiSchema;
+  allOf?: ApiSchema[];
+  oneOf?: ApiSchema[];
+  anyOf?: ApiSchema[];
+  not?: ApiSchema;
+  discriminator?: {
+    propertyName: string;
+    mapping?: Record<string, string>;
+  };
+  /** Validation keywords, such as `minimum` or `pattern`. */
+  constraints?: Record<string, unknown>;
+}
+interface ApiProperty {
+  name: string;
+  required: boolean;
+  schema: ApiSchema;
+}
+//#endregion
+//#region src/sources/openapi/markdown.d.ts
+interface OpenAPILinks {
+  /** URL paths by operation ID. */
+  operations: Record<string, string>;
+  /** URL paths of tag landing pages by tag name. */
+  tags: Record<string, string>;
+}
+//#endregion
+//#region src/sources/types.d.ts
+interface FileEntry {
+  id: string;
+  data: Record<string, unknown>;
+  /** Raw Markdown or MDX source. */
+  body?: string;
+}
+interface FileContent {
+  type: "file";
+  /** Astro collection entry, rendered with `render()`. */
+  entry: FileEntry;
+}
+interface AndesineContent {
+  type: "andesine";
+  /** HTML syntax tree, rendered with the template's content components. */
+  nodes: Root;
+  headings: HeadingContext[];
+  iconCSS: string;
+  /** Introduction content, before the body. */
+  summary?: Root;
+  /** Supporting content, after the body. */
+  aside?: Root;
+}
+interface OpenAPIContent {
+  type: "openapi";
+  /** The whole API, which the page's schemas refer to. */
+  model: ApiModel;
+  links: OpenAPILinks;
+  /** Set on operation pages. */
+  operation?: ApiOperation;
+  /** Set on tag landing pages. */
+  tag?: ApiTag;
+}
+interface SourcePage {
+  sourceID: string;
+  id: string;
+  /** Base-prefixed, encoded URL path with a trailing slash. */
+  href: string;
+  title: string;
+  description?: string;
+  toc: boolean;
+  layout: "docs" | "wide" | "reference";
+  /** Leaves the page out of search. Search results are not access control. */
+  searchHidden: boolean;
+  /** The page's Markdown alternative, without the title and description. */
+  markdown: string;
+  /** ISO date of the last content change, when known. */
+  updatedAt?: string;
+  content: FileContent | AndesineContent | OpenAPIContent;
+}
+interface SourceNode {
+  id: string;
+  label: string;
+  /** The page of a leaf, or the landing page of a group. */
+  page?: SourcePage;
+  /** The HTTP method of an API operation, e.g. `get`. */
+  method?: string;
+  /** Present for groups only. */
+  children?: SourceNode[];
+}
+interface SourceData {
+  id: string;
+  /** Base-prefixed URL path of the source mount. */
+  href: string;
+  /** All pages, including pages that are hidden from navigation. */
+  pages: SourcePage[];
+  navigation: SourceNode[];
+}
+//#endregion
+//#region src/navigation/sections.d.ts
+interface Section {
+  id: string;
+  label: string;
+  icon?: string;
+  links: IconLinkConfig[];
+  /** URL of the first page, or of the first source mount. */
+  href: string;
+  sources: SourceData[];
+  navigation: SourceNode[];
+}
+//#endregion
+//#region src/routing/routes.d.ts
+interface PageRoute {
+  type: "page";
+  href: string;
+  page: SourcePage;
+  section: Section;
+}
+interface RedirectRoute {
+  type: "redirect";
+  href: string;
+  target: string;
+}
+//#endregion
+//#region src/context/page.d.ts
+interface PageContextOptions {
+  site: SiteContext;
+  /** Configured sections; empty when the site uses the implicit section. */
+  sections: Section[];
+  route: PageRoute;
+  pageActions: PagesConfig["pageActions"];
+  image?: SocialImage;
+}
+declare const toSectionContexts: (sections: Section[], current?: Section) => SectionContext[];
+/** Creates the page context without headings, which exist only after rendering. */
+declare const createPageContext: (options: PageContextOptions) => Omit<PageContext, "headings">;
+//#endregion
+//#region src/context/meta.d.ts
+/** The document title, description, and type of a page. */
+declare const createPageMeta: (site: SiteContext, page: {
+  title: string;
+  description?: string;
+  href?: string;
+}) => PageMeta;
+//#endregion
+export { FilesSourceConfig as A, SiteContext as C, parseConfig as D, defineConfig as E, PagesConfigInput as F, SectionConfig as I, SourceConfig as L, LinkConfig as M, OpenAPISourceConfig as N, AIService as O, PagesConfig as P, configSchema as R, SectionContext as S, SocialImage as T, PageFragments as _, SourcePage as a, SearchContext as b, createSiteContext as c, BreadcrumbItem as d, HeadingContext as f, PageContext as g, PageActionsContext as h, RedirectRoute as i, IconLinkConfig as j, AndesineSourceConfig as k, AndesineAPIContext as l, OpenInLink as m, createPageContext as n, ApiModel as o, NavigationItem as p, toSectionContexts as r, ApiOperation as s, createPageMeta as t, AnswersContext as u, PageLink as v, SiteLogo as w, SearchSourceContext as x, PageMeta as y };
+//# sourceMappingURL=index-D8wL2B5s.d.ts.map

package/dist/chunks/index-vsu3hISM.d.ts

@@ -0,0 +1,62 @@
+import { P as PagesConfig, a as SourcePage, g as PageContext, i as RedirectRoute } from "./index-D8wL2B5s.js";
+import { g as HighlightOptions, r as OperationView } from "./view-Dlf_VRI7.js";
+import { n as SocialCardData } from "./types-DBzuXfSe.js";
+import { Root } from "hast";
+//#region src/site/index.d.ts
+interface PageRouteData {
+  type: "page";
+  content: SourcePage["content"];
+  toc: boolean;
+  sourceID: string;
+  /** The page is in the Pagefind index. */
+  indexed: boolean;
+  /** The Markdown alternative, with the title and description. */
+  markdown: string;
+  context: Omit<PageContext, "headings">;
+}
+interface StaticPath {
+  params: {
+    path?: string;
+  };
+  props: {
+    route: PageRouteData | RedirectRoute;
+  };
+}
+interface MarkdownPath {
+  params: {
+    path?: string;
+  };
+  props: {
+    markdown: string;
+  };
+}
+interface SocialPath {
+  params: {
+    path?: string;
+  };
+  props: {
+    data: SocialData;
+  };
+}
+interface RenderedRoute {
+  /** Astro content of a file page. */
+  Content?: unknown;
+  /** The operation of an OpenAPI operation page. */
+  operation?: OperationView;
+  /** HTML syntax tree of an Andesine page, or of an OpenAPI overview or tag page. */
+  nodes?: Root;
+  summary?: Root;
+  aside?: Root;
+  /** CSS for icons in the Andesine content. */
+  iconCSS?: string;
+  page: PageContext;
+}
+/** Card data without the configured images and brand, which the route adds. */
+type SocialData = Omit<SocialCardData, "logo" | "showSiteName" | "logoFormat" | "background" | "brand">;
+declare const getStaticPaths: (config: PagesConfig) => Promise<StaticPath[]>;
+/** The context of the not-found page, with the navigation of the first section. */
+declare const getNotFoundContext: (config: PagesConfig) => Promise<PageContext>;
+declare const renderRoute: (route: PageRouteData, highlight: HighlightOptions) => Promise<RenderedRoute>;
+//#endregion
+export { renderRoute as a, getStaticPaths as i, SocialPath as n, getNotFoundContext as r, MarkdownPath as t };
+//# sourceMappingURL=index-vsu3hISM.d.ts.map

package/dist/chunks/limits-Ppc7BQPG.js

@@ -0,0 +1,45 @@
+//#region src/search/items.ts
+const toAnchorHash = (anchor) => anchor ? `#${encodeURIComponent(anchor)}` : "";
+/** Maps search results to page links; results without a page are left out. */
+const toSearchItems = (results, resolve) => {
+	return results.flatMap((result) => {
+		const href = resolve(result);
+		const hash = toAnchorHash(result.anchor);
+		if (!href) return [];
+		return [{
+			id: `${result.entryID}${hash}`,
+			href: `${href}${hash}`,
+			title: result.title,
+			excerpt: result.snippet,
+			headingPath: result.headingPath
+		}];
+	});
+};
+/** Maps the pages that an answer cites to page links; sources without a page are left out. */
+const toAnswerSources = (sources, resolve) => {
+	return sources.flatMap((source) => {
+		const href = resolve(source);
+		if (!href) return [];
+		return [{
+			id: source.id,
+			href: `${href}${toAnchorHash(source.anchor)}`,
+			title: source.title,
+			headingPath: source.headingPath,
+			collectionPath: source.collectionPath
+		}];
+	});
+};
+//#endregion
+//#region src/search/limits.ts
+/** Used-up monthly quotas and spending limits show as unavailable, not as rate limits. */
+const isRateLimited = (status, data) => {
+	const limit = data?.limit;
+	return status === 429 && (limit === void 0 || limit === "rate");
+};
+const readErrorData = async (response) => {
+	return (await response.json().catch(() => null))?.data;
+};
+//#endregion
+export { toSearchItems as i, readErrorData as n, toAnswerSources as r, isRateLimited as t };
+
+//# sourceMappingURL=limits-Ppc7BQPG.js.map

package/dist/chunks/limits-Ppc7BQPG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits-Ppc7BQPG.js","names":[],"sources":["../../src/search/items.ts","../../src/search/limits.ts"],"sourcesContent":["import type { PublishedAnswerSource, PublishedSearchResult } from \"@andesine/sdk\";\nimport type { AnswerSource, SearchItem } from \"./types\";\n\n/** Maps an entry to its page URL; entries without a page give `undefined`. */\ntype PageResolver = (result: Pick<PublishedSearchResult, \"entryID\">) => string | undefined;\ntype SearchResult = Pick<\n  PublishedSearchResult,\n  \"entryID\" | \"anchor\" | \"title\" | \"snippet\" | \"headingPath\"\n>;\ntype CitedSource = Pick<\n  PublishedAnswerSource,\n  \"id\" | \"entryID\" | \"anchor\" | \"title\" | \"headingPath\" | \"collectionPath\"\n>;\n\nconst toAnchorHash = (anchor?: string): string => (anchor ? `#${encodeURIComponent(anchor)}` : \"\");\n/** Maps search results to page links; results without a page are left out. */\nconst toSearchItems = (results: SearchResult[], resolve: PageResolver): SearchItem[] => {\n  return results.flatMap((result) => {\n    const href = resolve(result);\n    const hash = toAnchorHash(result.anchor);\n\n    if (!href) return [];\n\n    return [\n      {\n        id: `${result.entryID}${hash}`,\n        href: `${href}${hash}`,\n        title: result.title,\n        excerpt: result.snippet,\n        headingPath: result.headingPath\n      }\n    ];\n  });\n};\n/** Maps the pages that an answer cites to page links; sources without a page are left out. */\nconst toAnswerSources = (sources: CitedSource[], resolve: PageResolver): AnswerSource[] => {\n  return sources.flatMap((source) => {\n    const href = resolve(source);\n\n    if (!href) return [];\n\n    return [\n      {\n        id: source.id,\n        href: `${href}${toAnchorHash(source.anchor)}`,\n        title: source.title,\n        headingPath: source.headingPath,\n        collectionPath: source.collectionPath\n      }\n    ];\n  });\n};\n\nexport { toAnchorHash, toSearchItems, toAnswerSources };\nexport type { PageResolver };\n","/** Used-up monthly quotas and spending limits show as unavailable, not as rate limits. */\nconst isRateLimited = (status: number, data: unknown): boolean => {\n  const limit = (data as { limit?: string } | null | undefined)?.limit;\n\n  return status === 429 && (limit === undefined || limit === \"rate\");\n};\nconst readErrorData = async (response: Response): Promise<unknown> => {\n  const body = (await response.json().catch(() => null)) as { data?: unknown } | null;\n\n  return body?.data;\n};\n\nexport { isRateLimited, readErrorData };\n"],"mappings":";AAcA,MAAM,gBAAgB,WAA6B,SAAS,IAAI,mBAAmB,MAAM,MAAM;;AAE/F,MAAM,iBAAiB,SAAyB,YAAwC;CACtF,OAAO,QAAQ,SAAS,WAAW;EACjC,MAAM,OAAO,QAAQ,MAAM;EAC3B,MAAM,OAAO,aAAa,OAAO,MAAM;EAEvC,IAAI,CAAC,MAAM,OAAO,CAAC;EAEnB,OAAO,CACL;GACE,IAAI,GAAG,OAAO,UAAU;GACxB,MAAM,GAAG,OAAO;GAChB,OAAO,OAAO;GACd,SAAS,OAAO;GAChB,aAAa,OAAO;EACtB,CACF;CACF,CAAC;AACH;;AAEA,MAAM,mBAAmB,SAAwB,YAA0C;CACzF,OAAO,QAAQ,SAAS,WAAW;EACjC,MAAM,OAAO,QAAQ,MAAM;EAE3B,IAAI,CAAC,MAAM,OAAO,CAAC;EAEnB,OAAO,CACL;GACE,IAAI,OAAO;GACX,MAAM,GAAG,OAAO,aAAa,OAAO,MAAM;GAC1C,OAAO,OAAO;GACd,aAAa,OAAO;GACpB,gBAAgB,OAAO;EACzB,CACF;CACF,CAAC;AACH;;;;AClDA,MAAM,iBAAiB,QAAgB,SAA2B;CAChE,MAAM,QAAS,MAAgD;CAE/D,OAAO,WAAW,QAAQ,UAAU,KAAA,KAAa,UAAU;AAC7D;AACA,MAAM,gBAAgB,OAAO,aAAyC;CAGpE,QAAO,MAFa,SAAS,KAAK,CAAC,CAAC,YAAY,IAAI,EAAA,EAEvC;AACf"}