@eightyfourthousand/client-graphql 2026.3.1 → 2026.4.1

package/src/lib/functions/get-glossary-entry.ts

@@ -1,136 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type { GlossaryPageItem, TohokuCatalogEntry } from '@eightyfourthousand/data-access';
-
-const GET_GLOSSARY_ENTRY = gql`
-  query GetGlossaryEntry($uuid: ID!) {
-    glossaryEntry(uuid: $uuid) {
-      authorityUuid
-      headword
-      language
-      classifications
-      definition
-      xmlId
-      english
-      tibetan
-      sanskrit
-      pali
-      chinese
-      relatedInstances {
-        workUuid
-        toh
-        definition
-        canon
-        english
-        tibetan
-        sanskrit
-        pali
-        chinese
-        creators
-      }
-      relatedEntities {
-        sourceHeadword
-        sourceUuid
-        targetHeadword
-        targetUuid
-      }
-    }
-  }
-`;
-
-type GraphQLGlossaryEntry = {
-  authorityUuid: string;
-  headword: string;
-  language: string;
-  classifications: string[];
-  definition: string | null;
-  xmlId: string | null;
-  english: string[];
-  tibetan: string[];
-  sanskrit: string[];
-  pali: string[];
-  chinese: string[];
-  relatedInstances: Array<{
-    workUuid: string;
-    toh: string;
-    definition: string | null;
-    canon: string | null;
-    english: string[];
-    tibetan: string[];
-    sanskrit: string[];
-    pali: string[];
-    chinese: string[];
-    creators: string[];
-  }>;
-  relatedEntities: Array<{
-    sourceHeadword: string;
-    sourceUuid: string;
-    targetHeadword: string;
-    targetUuid: string;
-  }>;
-};
-
-type GetGlossaryEntryResponse = {
-  glossaryEntry: GraphQLGlossaryEntry | null;
-};
-
-/**
- * Map GraphQL glossary entry to the GlossaryPageItem type.
- */
-function glossaryEntryFromGraphQL(
-  entry: GraphQLGlossaryEntry,
-): GlossaryPageItem {
-  return {
-    authorityUuid: entry.authorityUuid,
-    headword: entry.headword,
-    language: entry.language as GlossaryPageItem['language'],
-    classifications: entry.classifications,
-    definition: entry.definition ?? undefined,
-    xmlId: entry.xmlId ?? undefined,
-    english: entry.english,
-    tibetan: entry.tibetan,
-    sanskrit: entry.sanskrit,
-    pali: entry.pali,
-    chinese: entry.chinese,
-    relatedInstances: entry.relatedInstances.map((instance) => ({
-      workUuid: instance.workUuid,
-      toh: instance.toh as TohokuCatalogEntry,
-      definition: instance.definition ?? undefined,
-      canon: instance.canon ?? undefined,
-      english: instance.english,
-      tibetan: instance.tibetan,
-      sanskrit: instance.sanskrit,
-      pali: instance.pali,
-      chinese: instance.chinese,
-      creators: instance.creators,
-    })),
-    relatedEntities: entry.relatedEntities,
-  };
-}
-
-/**
- * Get a single glossary entry by UUID (for the detail page).
- */
-export async function getGlossaryEntry({
-  client,
-  uuid,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-}): Promise<GlossaryPageItem | null> {
-  try {
-    const response = await client.request<GetGlossaryEntryResponse>(
-      GET_GLOSSARY_ENTRY,
-      { uuid },
-    );
-
-    if (!response.glossaryEntry) {
-      return null;
-    }
-
-    return glossaryEntryFromGraphQL(response.glossaryEntry);
-  } catch (error) {
-    console.error('Error fetching glossary entry:', error);
-    return null;
-  }
-}

package/src/lib/functions/get-glossary-instance.ts

@@ -1,48 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type { GlossaryTermInstance } from '@eightyfourthousand/data-access';
-
-const GET_GLOSSARY_INSTANCE = gql`
-  query GetGlossaryInstance($uuid: ID!) {
-    glossaryInstance(uuid: $uuid) {
-      uuid
-      authority
-      definition
-      names {
-        english
-        tibetan
-        sanskrit
-        pali
-        chinese
-        wylie
-      }
-    }
-  }
-`;
-
-type GetGlossaryInstanceResponse = {
-  glossaryInstance: GlossaryTermInstance | null;
-};
-
-/**
- * Get a single glossary instance by UUID.
- */
-export async function getGlossaryInstance({
-  client,
-  uuid,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-}): Promise<GlossaryTermInstance | null> {
-  try {
-    const response = await client.request<GetGlossaryInstanceResponse>(
-      GET_GLOSSARY_INSTANCE,
-      { uuid },
-    );
-
-    return response.glossaryInstance;
-  } catch (error) {
-    console.error('Error fetching glossary instance:', error);
-    return null;
-  }
-}

package/src/lib/functions/get-glossary-terms.ts

@@ -1,44 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type { GlossaryLandingItem } from '@eightyfourthousand/data-access';
-
-const GET_GLOSSARY_TERMS = gql`
-  query GetGlossaryTerms($uuids: [ID!]) {
-    glossaryTerms(uuids: $uuids) {
-      uuid
-      headword
-      type
-      language
-      nameVariants
-      definition
-      numGlossaryEntries
-    }
-  }
-`;
-
-type GetGlossaryTermsResponse = {
-  glossaryTerms: GlossaryLandingItem[];
-};
-
-/**
- * Get all glossary terms for the landing page, optionally filtered by UUIDs.
- */
-export async function getGlossaryTerms({
-  client,
-  uuids,
-}: {
-  client: GraphQLClient;
-  uuids?: string[];
-}): Promise<GlossaryLandingItem[]> {
-  try {
-    const response = await client.request<GetGlossaryTermsResponse>(
-      GET_GLOSSARY_TERMS,
-      { uuids },
-    );
-
-    return response.glossaryTerms;
-  } catch (error) {
-    console.error('Error fetching glossary terms:', error);
-    return [];
-  }
-}

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

@@ -1,78 +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!) {
-    passage(uuid: $uuid) {
-      ...PassageWithAnnotations
-    }
-  }
-`;
-
-type GetPassageResponse = {
-  passage: GraphQLPassage | null;
-};
-
-/**
- * Get a single passage by UUID.
- */
-export async function getPassage({
-  client,
-  uuid,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-}): Promise<Passage | undefined> {
-  try {
-    const response = await client.request<GetPassageResponse>(GET_PASSAGE, {
-      uuid,
-    });
-
-    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,131 +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.
- *
- * Unlike getTranslationPassagesAround which returns Passage objects,
- * this function 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,160 +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.
- *
- * Unlike getTranslationPassages which returns Passage objects,
- * this function 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,
-    };
-  }
-}