@eightyfourthousand/client-graphql 2026.4.0 → 2026.4.1

package/src/lib/functions/get-passage.ts

@@ -1,81 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type { Passage } from '@eightyfourthousand/data-access';
-import { passageFromGraphQL, type GraphQLPassage } from '../mappers';
-
-const GET_PASSAGE = gql`
-  fragment AnnotationFields on Annotation {
-    uuid
-    type
-    start
-    end
-    metadata
-  }
-
-  fragment AlignmentFields on Alignment {
-    folioUuid
-    toh
-    tibetan
-    folioNumber
-    volumeNumber
-  }
-
-  fragment PassageFields on Passage {
-    uuid
-    workUuid
-    content
-    label
-    sort
-    type
-    xmlId
-  }
-
-  fragment PassageWithAnnotations on Passage {
-    ...PassageFields
-    annotations {
-      ...AnnotationFields
-    }
-    alignments {
-      ...AlignmentFields
-    }
-  }
-
-  query GetPassage($uuid: ID, $xmlId: String) {
-    passage(uuid: $uuid, xmlId: $xmlId) {
-      ...PassageWithAnnotations
-    }
-  }
-`;
-
-type GetPassageResponse = {
-  passage: GraphQLPassage | null;
-};
-
-/**
- * Get a single passage by UUID or XML ID.
- */
-export async function getPassage({
-  client,
-  uuid,
-  xmlId,
-}: {
-  client: GraphQLClient;
-  uuid?: string;
-  xmlId?: string;
-}): Promise<Passage | undefined> {
-  try {
-    const response = await client.request<GetPassageResponse>(GET_PASSAGE, {
-      uuid,
-      xmlId,
-    });
-
-    if (!response.passage) {
-      return undefined;
-    }
-
-    return passageFromGraphQL(response.passage);
-  } catch (error) {
-    console.error('Error fetching passage:', error);
-    return undefined;
-  }
-}

package/src/lib/functions/get-term-passages.ts

@@ -1,53 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-
-const GET_TERM_PASSAGES = gql`
-  query GetTermPassages($uuid: ID!, $first: Int, $after: String) {
-    glossaryTermPassages(uuid: $uuid, first: $first, after: $after) {
-      items {
-        uuid
-        type
-        label
-        sort
-      }
-      nextCursor
-      hasMore
-    }
-  }
-`;
-
-export type GlossaryPassagesPage = {
-  items: Array<{ uuid: string; type: string; label: string; sort: number }>;
-  nextCursor: string | null;
-  hasMore: boolean;
-};
-
-type GetTermPassagesResponse = {
-  glossaryTermPassages: GlossaryPassagesPage;
-};
-
-/**
- * Fetch a page of passage references for a single glossary term instance.
- */
-export async function getTermPassages({
-  client,
-  uuid,
-  first = 10,
-  after,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-  first?: number;
-  after?: string;
-}): Promise<GlossaryPassagesPage> {
-  try {
-    const response = await client.request<GetTermPassagesResponse>(
-      GET_TERM_PASSAGES,
-      { uuid, first, after },
-    );
-    return response.glossaryTermPassages;
-  } catch (error) {
-    console.error('Error fetching term passages:', error);
-    return { items: [], nextCursor: null, hasMore: false };
-  }
-}

package/src/lib/functions/get-translation-blocks-around.ts

@@ -1,129 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type { BodyItemType, TranslationEditorContentItem } from '@eightyfourthousand/data-access';
-import type { TranslationBlocksPage } from './get-translation-blocks';
-
-const GET_PASSAGES_AROUND_WITH_JSON = gql`
-  fragment PassageWithJson on Passage {
-    uuid
-    workUuid
-    label
-    sort
-    type
-    xmlId
-    json
-  }
-
-  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
-        }
-      }
-    }
-  }
-`;
-
-type PassageWithJson = {
-  uuid: string;
-  workUuid: string;
-  label: string;
-  sort: number;
-  type: string;
-  xmlId?: string | null;
-  json?: unknown | null;
-};
-
-type GetPassagesAroundWithJsonResponse = {
-  work: {
-    uuid: string;
-    passages: {
-      nodes: PassageWithJson[];
-      pageInfo: {
-        nextCursor?: string | null;
-        prevCursor?: string | null;
-        hasMoreAfter: boolean;
-        hasMoreBefore: boolean;
-      };
-    };
-  } | null;
-};
-
-/**
- * Get translation blocks (TipTap JSON) around a specific passage UUID.
- *
- * Returns pre-transformed TipTap editor blocks ready for rendering.
- */
-export async function getTranslationBlocksAround({
-  client,
-  uuid,
-  passageUuid,
-  type,
-  maxPassages,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-  passageUuid: string;
-  type?: BodyItemType | string;
-  maxPassages?: number;
-}): Promise<TranslationBlocksPage> {
-  try {
-    const response = await client.request<GetPassagesAroundWithJsonResponse>(
-      GET_PASSAGES_AROUND_WITH_JSON,
-      {
-        uuid,
-        cursor: passageUuid,
-        limit: maxPassages,
-        filter: type ? { type } : undefined,
-      },
-    );
-
-    if (!response.work) {
-      return {
-        blocks: [],
-        hasMoreAfter: false,
-        hasMoreBefore: false,
-      };
-    }
-
-    const { passages } = response.work;
-
-    // Extract the JSON blocks, filtering out any null values
-    const blocks = passages.nodes
-      .map((node) => node.json)
-      .filter((json): json is TranslationEditorContentItem => json != null);
-
-    return {
-      blocks,
-      nextCursor: passages.pageInfo.nextCursor ?? undefined,
-      prevCursor: passages.pageInfo.prevCursor ?? undefined,
-      hasMoreAfter: passages.pageInfo.hasMoreAfter,
-      hasMoreBefore: passages.pageInfo.hasMoreBefore,
-    };
-  } catch (error) {
-    console.error('Error fetching translation blocks around:', error);
-    return {
-      blocks: [],
-      hasMoreAfter: false,
-      hasMoreBefore: false,
-    };
-  }
-}

package/src/lib/functions/get-translation-blocks.ts

@@ -1,158 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type {
-  BodyItemType,
-  PaginationDirection,
-  TranslationEditorContent,
-  TranslationEditorContentItem,
-} from '@eightyfourthousand/data-access';
-
-const GET_PASSAGES_WITH_JSON = gql`
-  fragment PassageWithJson on Passage {
-    uuid
-    workUuid
-    label
-    sort
-    type
-    xmlId
-    json
-  }
-
-  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
-        }
-      }
-    }
-  }
-`;
-
-type PassageWithJson = {
-  uuid: string;
-  workUuid: string;
-  label: string;
-  sort: number;
-  type: string;
-  xmlId?: string | null;
-  json?: unknown | null;
-};
-
-type GetPassagesWithJsonResponse = {
-  work: {
-    uuid: string;
-    passages: {
-      nodes: PassageWithJson[];
-      pageInfo: {
-        nextCursor?: string | null;
-        prevCursor?: string | null;
-        hasMoreAfter: boolean;
-        hasMoreBefore: boolean;
-      };
-    };
-  } | null;
-};
-
-/**
- * Result of fetching translation blocks with pagination info
- */
-export type TranslationBlocksPage = {
-  blocks: TranslationEditorContent;
-  nextCursor?: string;
-  prevCursor?: string;
-  hasMoreAfter: boolean;
-  hasMoreBefore: boolean;
-};
-
-/**
- * Map internal pagination direction to GraphQL enum
- */
-function mapDirection(
-  direction?: PaginationDirection,
-): 'FORWARD' | 'BACKWARD' | undefined {
-  if (!direction) return undefined;
-  return direction === 'forward' ? 'FORWARD' : 'BACKWARD';
-}
-
-/**
- * Get paginated translation blocks (TipTap JSON) for a work.
- *
- * Returns pre-transformed TipTap editor blocks ready for rendering.
- */
-export async function getTranslationBlocks({
-  client,
-  uuid,
-  type,
-  cursor,
-  maxPassages = 100,
-  direction,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-  type?: BodyItemType | string;
-  cursor?: string;
-  maxPassages?: number;
-  direction?: PaginationDirection;
-}): Promise<TranslationBlocksPage> {
-  try {
-    const response = await client.request<GetPassagesWithJsonResponse>(
-      GET_PASSAGES_WITH_JSON,
-      {
-        uuid,
-        cursor,
-        limit: maxPassages,
-        direction: mapDirection(direction),
-        filter: type ? { type } : undefined,
-      },
-    );
-
-    if (!response.work) {
-      return {
-        blocks: [],
-        hasMoreAfter: false,
-        hasMoreBefore: false,
-      };
-    }
-
-    const { passages } = response.work;
-
-    // Extract the JSON blocks, filtering out any null values
-    const blocks = passages.nodes
-      .map((node) => node.json)
-      .filter((json): json is TranslationEditorContentItem => json != null);
-
-    return {
-      blocks,
-      nextCursor: passages.pageInfo.nextCursor ?? undefined,
-      prevCursor: passages.pageInfo.prevCursor ?? undefined,
-      hasMoreAfter: passages.pageInfo.hasMoreAfter,
-      hasMoreBefore: passages.pageInfo.hasMoreBefore,
-    };
-  } catch (error) {
-    console.error('Error fetching translation blocks:', error);
-    return {
-      blocks: [],
-      hasMoreAfter: false,
-      hasMoreBefore: false,
-    };
-  }
-}

package/src/lib/functions/get-translation-imprint.ts

@@ -1,114 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type { Imprint } from '@eightyfourthousand/data-access';
-import { imprintFromGraphQL } from '../mappers';
-
-const GET_WORK_WITH_IMPRINT = gql`
-  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
-    }
-  }
-
-  query GetWorkWithImprint($uuid: ID!, $toh: String) {
-    work(uuid: $uuid, toh: $toh) {
-      uuid
-      imprint {
-        ...ImprintFields
-      }
-    }
-  }
-`;
-
-type GetWorkWithImprintResponse = {
-  work: {
-    uuid: string;
-    imprint: {
-      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?: {
-        tibetan?: string | null;
-        english?: string | null;
-        wylie?: string | null;
-        sanskrit?: string | null;
-      } | null;
-      longTitles?: {
-        tibetan?: string | null;
-        english?: string | null;
-        wylie?: string | null;
-        sanskrit?: string | null;
-      } | null;
-    } | null;
-  } | null;
-};
-
-/**
- * Get the imprint for a translation work.
- */
-export async function getTranslationImprint({
-  client,
-  uuid,
-  toh,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-  toh: string;
-}): Promise<Imprint | undefined> {
-  try {
-    const response = await client.request<GetWorkWithImprintResponse>(
-      GET_WORK_WITH_IMPRINT,
-      { uuid, toh },
-    );
-
-    if (!response.work?.imprint) {
-      return undefined;
-    }
-
-    return imprintFromGraphQL(response.work.imprint, response.work.uuid);
-  } catch (error) {
-    console.error('Error fetching translation imprint:', error);
-    return undefined;
-  }
-}

package/src/lib/functions/get-translation-metadata.ts

@@ -1,99 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type { Work } from '@eightyfourthousand/data-access';
-import { workFromGraphQL } from '../mappers';
-
-const GET_WORK_BY_UUID = gql`
-  query GetWorkByUuid($uuid: ID!) {
-    work(uuid: $uuid) {
-      uuid
-      title
-      toh
-      publicationDate
-      publicationVersion
-      pages
-      restriction
-      section
-    }
-  }
-`;
-
-const GET_WORK_BY_TOH = gql`
-  query GetWorkByToh($toh: String!) {
-    work(toh: $toh) {
-      uuid
-      title
-      toh
-      publicationDate
-      publicationVersion
-      pages
-      restriction
-      section
-    }
-  }
-`;
-
-type GetWorkResponse = {
-  work: {
-    uuid: string;
-    title: string;
-    toh: string[];
-    publicationDate: string;
-    publicationVersion: string;
-    pages: number;
-    restriction: boolean;
-    section: string;
-  } | null;
-};
-
-/**
- * Get work metadata by UUID.
- */
-export async function getTranslationMetadataByUuid({
-  client,
-  uuid,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-}): Promise<Work | null> {
-  try {
-    const response = await client.request<GetWorkResponse>(GET_WORK_BY_UUID, {
-      uuid,
-    });
-
-    if (!response.work) {
-      return null;
-    }
-
-    return workFromGraphQL(response.work);
-  } catch (error) {
-    console.error('Error fetching translation metadata by UUID:', error);
-    return null;
-  }
-}
-
-/**
- * Get work metadata by Tohoku catalog number.
- */
-export async function getTranslationMetadataByToh({
-  client,
-  toh,
-}: {
-  client: GraphQLClient;
-  toh: string;
-}): Promise<Work | null> {
-  try {
-    const response = await client.request<GetWorkResponse>(GET_WORK_BY_TOH, {
-      toh,
-    });
-
-    if (!response.work) {
-      return null;
-    }
-
-    return workFromGraphQL(response.work);
-  } catch (error) {
-    console.error('Error fetching translation metadata by toh:', error);
-    return null;
-  }
-}

package/src/lib/functions/get-translation-titles.ts

@@ -1,55 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type { Titles } from '@eightyfourthousand/data-access';
-import { titlesFromGraphQL } from '../mappers';
-
-const GET_WORK_TITLES = gql`
-  query GetWorkWithTitles($uuid: ID!) {
-    work(uuid: $uuid) {
-      titles {
-        uuid
-        content
-        language
-        type
-      }
-    }
-  }
-`;
-
-type GetWorkTitlesResponse = {
-  work: {
-    titles: Array<{
-      uuid: string;
-      content: string;
-      language: string;
-      type: string;
-    }>;
-  } | null;
-};
-
-/**
- * Get all titles for a work.
- */
-export async function getTranslationTitles({
-  client,
-  uuid,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-}): Promise<Titles> {
-  try {
-    const response = await client.request<GetWorkTitlesResponse>(
-      GET_WORK_TITLES,
-      { uuid },
-    );
-
-    if (!response.work) {
-      return [];
-    }
-
-    return titlesFromGraphQL(response.work.titles);
-  } catch (error) {
-    console.error('Error fetching translation titles:', error);
-    return [];
-  }
-}