@eightyfourthousand/client-graphql 2026.3.0

package/src/lib/graphql/fragments/alignment.graphql

@@ -0,0 +1,7 @@
+fragment AlignmentFields on Alignment {
+  folioUuid
+  toh
+  tibetan
+  folioNumber
+  volumeNumber
+}

package/src/lib/graphql/fragments/annotation.graphql

@@ -0,0 +1,7 @@
+fragment AnnotationFields on Annotation {
+  uuid
+  type
+  start
+  end
+  metadata
+}

package/src/lib/graphql/fragments/imprint.graphql

@@ -0,0 +1,34 @@
+fragment LicenseFields on License {
+  name
+  link
+  description
+}
+
+fragment TitlesByLanguageFields on TitlesByLanguage {
+  tibetan
+  english
+  wylie
+  sanskrit
+}
+
+fragment ImprintFields on Imprint {
+  toh
+  section
+  version
+  restriction
+  publishYear
+  tibetanAuthors
+  isAuthorContested
+  sourceDescription
+  publisherStatement
+  tibetanTranslators
+  license {
+    ...LicenseFields
+  }
+  mainTitles {
+    ...TitlesByLanguageFields
+  }
+  longTitles {
+    ...TitlesByLanguageFields
+  }
+}

package/src/lib/graphql/fragments/passage.graphql

@@ -0,0 +1,29 @@
+fragment PassageFields on Passage {
+  uuid
+  workUuid
+  content
+  label
+  sort
+  type
+  xmlId
+}
+
+fragment PassageWithAnnotations on Passage {
+  ...PassageFields
+  annotations {
+    ...AnnotationFields
+  }
+  alignments {
+    ...AlignmentFields
+  }
+}
+
+fragment PassageWithJson on Passage {
+  uuid
+  workUuid
+  label
+  sort
+  type
+  xmlId
+  json
+}

package/src/lib/graphql/fragments/title.graphql

@@ -0,0 +1,6 @@
+fragment TitleFields on Title {
+  uuid
+  content
+  language
+  type
+}

package/src/lib/graphql/fragments/toc.graphql

@@ -0,0 +1,40 @@
+fragment TocEntryFields on TocEntry {
+  uuid
+  content
+  label
+  sort
+  level
+  section
+}
+
+# Recursive fragment for TOC entries up to 6 levels deep
+fragment TocEntryNested on TocEntry {
+  ...TocEntryFields
+  children {
+    ...TocEntryFields
+    children {
+      ...TocEntryFields
+      children {
+        ...TocEntryFields
+        children {
+          ...TocEntryFields
+          children {
+            ...TocEntryFields
+          }
+        }
+      }
+    }
+  }
+}
+
+fragment TocFields on Toc {
+  frontMatter {
+    ...TocEntryNested
+  }
+  body {
+    ...TocEntryNested
+  }
+  backMatter {
+    ...TocEntryNested
+  }
+}

package/src/lib/graphql/fragments/work.graphql

@@ -0,0 +1,10 @@
+fragment WorkFields on Work {
+  uuid
+  title
+  toh
+  publicationDate
+  publicationVersion
+  pages
+  restriction
+  section
+}

package/src/lib/graphql/queries/passages.graphql

@@ -0,0 +1,116 @@
+query GetPassages(
+  $uuid: ID!
+  $cursor: String
+  $limit: Int
+  $direction: PaginationDirection
+  $filter: PassageFilter
+) {
+  work(uuid: $uuid) {
+    uuid
+    passages(
+      cursor: $cursor
+      limit: $limit
+      direction: $direction
+      filter: $filter
+    ) {
+      nodes {
+        ...PassageWithAnnotations
+      }
+      pageInfo {
+        nextCursor
+        prevCursor
+        hasMoreAfter
+        hasMoreBefore
+      }
+    }
+  }
+}
+
+query GetPassagesBasic(
+  $uuid: ID!
+  $cursor: String
+  $limit: Int
+  $direction: PaginationDirection
+  $filter: PassageFilter
+) {
+  work(uuid: $uuid) {
+    uuid
+    passages(
+      cursor: $cursor
+      limit: $limit
+      direction: $direction
+      filter: $filter
+    ) {
+      nodes {
+        ...PassageFields
+      }
+      pageInfo {
+        nextCursor
+        prevCursor
+        hasMoreAfter
+        hasMoreBefore
+      }
+    }
+  }
+}
+
+query GetPassagesWithJson(
+  $uuid: ID!
+  $cursor: String
+  $limit: Int
+  $direction: PaginationDirection
+  $filter: PassageFilter
+) {
+  work(uuid: $uuid) {
+    uuid
+    passages(
+      cursor: $cursor
+      limit: $limit
+      direction: $direction
+      filter: $filter
+    ) {
+      nodes {
+        ...PassageWithJson
+      }
+      pageInfo {
+        nextCursor
+        prevCursor
+        hasMoreAfter
+        hasMoreBefore
+      }
+    }
+  }
+}
+
+query GetPassagesAroundWithJson(
+  $uuid: ID!
+  $cursor: String!
+  $limit: Int
+  $filter: PassageFilter
+) {
+  work(uuid: $uuid) {
+    uuid
+    passages(
+      cursor: $cursor
+      limit: $limit
+      direction: AROUND
+      filter: $filter
+    ) {
+      nodes {
+        ...PassageWithJson
+      }
+      pageInfo {
+        nextCursor
+        prevCursor
+        hasMoreAfter
+        hasMoreBefore
+      }
+    }
+  }
+}
+
+query GetPassage($uuid: ID!) {
+  passage(uuid: $uuid) {
+    ...PassageWithAnnotations
+  }
+}

package/src/lib/graphql/queries/work.graphql

@@ -0,0 +1,38 @@
+query GetWorkByUuid($uuid: ID!) {
+  work(uuid: $uuid) {
+    ...WorkFields
+  }
+}
+
+query GetWorkByToh($toh: String!) {
+  work(toh: $toh) {
+    ...WorkFields
+  }
+}
+
+query GetWorkWithTitles($uuid: ID!) {
+  work(uuid: $uuid) {
+    ...WorkFields
+    titles {
+      ...TitleFields
+    }
+  }
+}
+
+query GetWorkWithImprint($uuid: ID!, $toh: String) {
+  work(uuid: $uuid, toh: $toh) {
+    ...WorkFields
+    imprint {
+      ...ImprintFields
+    }
+  }
+}
+
+query GetWorkWithToc($uuid: ID!) {
+  work(uuid: $uuid) {
+    ...WorkFields
+    toc {
+      ...TocFields
+    }
+  }
+}

package/src/lib/graphql/queries/works.graphql

@@ -0,0 +1,23 @@
+query GetAllWorks($cursor: String, $limit: Int) {
+  works(cursor: $cursor, limit: $limit) {
+    items {
+      ...WorkFields
+    }
+    pageInfo {
+      nextCursor
+      hasMoreAfter
+    }
+  }
+}
+
+query GetWorkUuids($cursor: String, $limit: Int) {
+  works(cursor: $cursor, limit: $limit) {
+    items {
+      uuid
+    }
+    pageInfo {
+      nextCursor
+      hasMoreAfter
+    }
+  }
+}

package/src/lib/mappers/alignment.ts

@@ -0,0 +1,34 @@
+import type { Alignment, TohokuCatalogEntry } from '@eightyfourthousand/data-access';
+
+/**
+ * GraphQL Alignment type from generated code
+ */
+export type GraphQLAlignment = {
+  folioUuid: string;
+  toh: string;
+  tibetan: string;
+  folioNumber: number;
+  volumeNumber: number;
+};
+
+/**
+ * Convert a GraphQL alignment to the internal Alignment type
+ */
+export function alignmentFromGraphQL(gqlAlignment: GraphQLAlignment): Alignment {
+  return {
+    folioUuid: gqlAlignment.folioUuid,
+    toh: gqlAlignment.toh as TohokuCatalogEntry,
+    tibetan: gqlAlignment.tibetan,
+    folioNumber: gqlAlignment.folioNumber,
+    volumeNumber: gqlAlignment.volumeNumber,
+  };
+}
+
+/**
+ * Convert an array of GraphQL alignments to internal Alignment types
+ */
+export function alignmentsFromGraphQL(
+  gqlAlignments: GraphQLAlignment[],
+): Alignment[] {
+  return gqlAlignments.map(alignmentFromGraphQL);
+}

package/src/lib/mappers/annotation.ts

@@ -0,0 +1,204 @@
+import {
+  type Annotation,
+  type Annotations,
+  type AnnotationType,
+  type HeadingClass,
+  type ExtendedTranslationLanguage,
+  ANNOTATION_TYPE_DTO_TO_TYPE,
+} from '@eightyfourthousand/data-access';
+
+/**
+ * GraphQL Annotation type from generated code
+ */
+export type GraphQLAnnotation = {
+  uuid: string;
+  type: string;
+  start: number;
+  end: number;
+  metadata?: Record<string, unknown> | null;
+};
+
+/**
+ * Map from DTO-style type names (kebab-case) to internal type names (camelCase)
+ */
+const typeMap: Record<string, AnnotationType> = {
+  ...ANNOTATION_TYPE_DTO_TO_TYPE,
+  // Also handle camelCase types (from GraphQL)
+  endNoteLink: 'endNoteLink',
+  glossaryInstance: 'glossaryInstance',
+  hasAbbreviation: 'hasAbbreviation',
+  inlineTitle: 'inlineTitle',
+  internalLink: 'internalLink',
+  leadingSpace: 'leadingSpace',
+  lineGroup: 'lineGroup',
+  listItem: 'listItem',
+  tableBodyData: 'tableBodyData',
+  tableBodyHeader: 'tableBodyHeader',
+  tableBodyRow: 'tableBodyRow',
+};
+
+/**
+ * Convert a GraphQL annotation to the internal Annotation type
+ */
+export function annotationFromGraphQL(
+  gqlAnnotation: GraphQLAnnotation,
+  passageUuid: string,
+): Annotation {
+  const type = typeMap[gqlAnnotation.type] || 'unknown';
+  const metadata = gqlAnnotation.metadata || {};
+
+  const base = {
+    uuid: gqlAnnotation.uuid,
+    type,
+    start: gqlAnnotation.start,
+    end: gqlAnnotation.end,
+    passageUuid,
+    validated: true,
+  };
+
+  // Extract type-specific fields from metadata
+  switch (type) {
+    case 'heading':
+      return {
+        ...base,
+        type: 'heading',
+        level: (metadata.level as number) ?? 1,
+        class: metadata.class as HeadingClass | undefined,
+      };
+
+    case 'link':
+      return {
+        ...base,
+        type: 'link',
+        href: (metadata.href as string) ?? '',
+        text: (metadata.text as string) ?? '',
+      };
+
+    case 'internalLink':
+      return {
+        ...base,
+        type: 'internalLink',
+        linkType: (metadata.linkType as string) ?? '',
+        href: metadata.href as string | undefined,
+        label: metadata.label as string | undefined,
+        entity: metadata.entity as string | undefined,
+        isPending: metadata.isPending as boolean | undefined,
+        isSameWork: metadata.isSameWork as boolean | undefined,
+        subtype: metadata.subtype as string | undefined,
+        linkToh: metadata.linkToh as string | undefined,
+      };
+
+    case 'span':
+      return {
+        ...base,
+        type: 'span',
+        textStyle: metadata.textStyle as string | undefined,
+        lang: metadata.lang as ExtendedTranslationLanguage | undefined,
+      };
+
+    case 'mantra':
+      return {
+        ...base,
+        type: 'mantra',
+        lang: (metadata.lang as ExtendedTranslationLanguage) ?? 'Sa-Ltn',
+      };
+
+    case 'inlineTitle':
+      return {
+        ...base,
+        type: 'inlineTitle',
+        lang: (metadata.lang as ExtendedTranslationLanguage) ?? 'Sa-Ltn',
+      };
+
+    case 'audio':
+      return {
+        ...base,
+        type: 'audio',
+        src: (metadata.src as string) ?? '',
+        mediaType: (metadata.mediaType as string) ?? '',
+      };
+
+    case 'image':
+      return {
+        ...base,
+        type: 'image',
+        src: (metadata.src as string) ?? '',
+      };
+
+    case 'list':
+      return {
+        ...base,
+        type: 'list',
+        spacing: metadata.spacing as string | undefined,
+        nesting: metadata.nesting as number | undefined,
+        itemStyle: metadata.itemStyle as string | undefined,
+      };
+
+    case 'glossaryInstance':
+      return {
+        ...base,
+        type: 'glossaryInstance',
+        authority: (metadata.authority as string) ?? '',
+        glossary: (metadata.glossary as string) ?? '',
+      };
+
+    case 'endNoteLink':
+      return {
+        ...base,
+        type: 'endNoteLink',
+        endNote: (metadata.endNote as string) ?? '',
+        label: metadata.label as string | undefined,
+      };
+
+    case 'abbreviation':
+      return {
+        ...base,
+        type: 'abbreviation',
+        abbreviation: (metadata.abbreviation as string) ?? '',
+      };
+
+    case 'hasAbbreviation':
+      return {
+        ...base,
+        type: 'hasAbbreviation',
+        abbreviation: (metadata.abbreviation as string) ?? '',
+      };
+
+    case 'quote':
+      return {
+        ...base,
+        type: 'quote',
+        quote: metadata.quote as string | undefined,
+      };
+
+    case 'quoted':
+      return {
+        ...base,
+        type: 'quoted',
+        quote: metadata.quote as string | undefined,
+      };
+
+    default:
+      // For types with no additional fields
+      return base as Annotation;
+  }
+}
+
+/**
+ * Convert an array of GraphQL annotations to internal Annotation types
+ */
+export function annotationsFromGraphQL(
+  gqlAnnotations: GraphQLAnnotation[],
+  passageUuid: string,
+): Annotations {
+  // Filter out ignored annotation types
+  const ignoredTypes = [
+    'deprecated-internal-link',
+    'quoted',
+    'reference',
+    'unknown',
+  ];
+  const filtered = gqlAnnotations.filter((a) => !ignoredTypes.includes(a.type));
+
+  return filtered.map((a) => annotationFromGraphQL(a, passageUuid));
+}

package/src/lib/mappers/imprint.ts

@@ -0,0 +1,79 @@
+import type { Imprint, SemVer, TranslationLanguage } from '@eightyfourthousand/data-access';
+
+/**
+ * GraphQL TitlesByLanguage type
+ */
+type GraphQLTitlesByLanguage = {
+  tibetan?: string | null;
+  english?: string | null;
+  wylie?: string | null;
+  sanskrit?: string | null;
+};
+
+/**
+ * GraphQL Imprint type
+ */
+export type GraphQLImprint = {
+  toh: string;
+  section?: string | null;
+  version?: string | null;
+  restriction?: boolean | null;
+  publishYear?: string | null;
+  tibetanAuthors?: string[] | null;
+  isAuthorContested: boolean;
+  sourceDescription?: string | null;
+  publisherStatement?: string | null;
+  tibetanTranslators?: string | null;
+  license: {
+    name?: string | null;
+    link?: string | null;
+    description?: string | null;
+  } | null;
+  mainTitles?: GraphQLTitlesByLanguage | null;
+  longTitles?: GraphQLTitlesByLanguage | null;
+};
+
+/**
+ * Map GraphQL TitlesByLanguage to internal TranslationLanguage keyed record
+ */
+function titlesFromGraphQL(
+  gqlTitles?: GraphQLTitlesByLanguage | null,
+): Partial<{ [key in TranslationLanguage]: string }> | undefined {
+  if (!gqlTitles) return undefined;
+
+  const result: Partial<{ [key in TranslationLanguage]: string }> = {};
+  if (gqlTitles.tibetan) result['bo'] = gqlTitles.tibetan;
+  if (gqlTitles.english) result['en'] = gqlTitles.english;
+  if (gqlTitles.wylie) result['Bo-Ltn'] = gqlTitles.wylie;
+  if (gqlTitles.sanskrit) result['Sa-Ltn'] = gqlTitles.sanskrit;
+  return Object.keys(result).length > 0 ? result : undefined;
+}
+
+/**
+ * Convert a GraphQL Imprint to the internal Imprint type
+ */
+export function imprintFromGraphQL(
+  gqlImprint: GraphQLImprint,
+  workUuid: string,
+): Imprint {
+  return {
+    uuid: workUuid,
+    toh: gqlImprint.toh,
+    section: gqlImprint.section || undefined,
+    version: (gqlImprint.version as SemVer) || undefined,
+    restriction: gqlImprint.restriction || undefined,
+    publishYear: gqlImprint.publishYear || undefined,
+    tibetanAuthors: gqlImprint.tibetanAuthors || undefined,
+    isAuthorContested: gqlImprint.isAuthorContested,
+    sourceDescription: gqlImprint.sourceDescription || undefined,
+    publisherStatement: gqlImprint.publisherStatement || undefined,
+    tibetanTranslators: gqlImprint.tibetanTranslators || undefined,
+    license: {
+      link: gqlImprint.license?.link || undefined,
+      name: gqlImprint.license?.name || undefined,
+      description: gqlImprint.license?.description || undefined,
+    },
+    mainTitles: titlesFromGraphQL(gqlImprint.mainTitles),
+    longTitles: titlesFromGraphQL(gqlImprint.longTitles),
+  };
+}

package/src/lib/mappers/index.ts

@@ -0,0 +1,7 @@
+export * from './alignment';
+export * from './annotation';
+export * from './imprint';
+export * from './passage';
+export * from './title';
+export * from './toc';
+export * from './work';