@eightyfourthousand/client-graphql 2026.3.1 → 2026.4.1

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-passages-around.ts

@@ -1,153 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type { BodyItemType, PassagesPage } from '@eightyfourthousand/data-access';
-import { passagesPageFromGraphQL } from '../mappers';
-
-const GET_PASSAGES_AROUND = gql`
-  fragment AnnotationFields on Annotation {
-    uuid
-    type
-    start
-    end
-    metadata
-  }
-
-  fragment AlignmentFields on Alignment {
-    folioUuid
-    toh
-    tibetan
-    folioNumber
-    volumeNumber
-  }
-
-  fragment PassageWithAnnotations on Passage {
-    uuid
-    workUuid
-    content
-    label
-    sort
-    type
-    xmlId
-    annotations {
-      ...AnnotationFields
-    }
-    alignments {
-      ...AlignmentFields
-    }
-  }
-
-  query GetPassagesAround(
-    $uuid: ID!
-    $cursor: String!
-    $limit: Int
-    $filter: PassageFilter
-  ) {
-    work(uuid: $uuid) {
-      uuid
-      passages(
-        cursor: $cursor
-        limit: $limit
-        direction: AROUND
-        filter: $filter
-      ) {
-        nodes {
-          ...PassageWithAnnotations
-        }
-        pageInfo {
-          nextCursor
-          prevCursor
-          hasMoreAfter
-          hasMoreBefore
-        }
-      }
-    }
-  }
-`;
-
-type GetPassagesAroundResponse = {
-  work: {
-    uuid: string;
-    passages: {
-      nodes: Array<{
-        uuid: string;
-        workUuid: string;
-        content: string;
-        label: string;
-        sort: number;
-        type: string;
-        xmlId?: string | null;
-        annotations: Array<{
-          uuid: string;
-          type: string;
-          start: number;
-          end: number;
-          metadata?: Record<string, unknown> | null;
-        }>;
-        alignments: Array<{
-          folioUuid: string;
-          toh: string;
-          tibetan: string;
-          folioNumber: number;
-          volumeNumber: number;
-        }>;
-      }>;
-      pageInfo: {
-        nextCursor?: string | null;
-        prevCursor?: string | null;
-        hasMoreAfter: boolean;
-        hasMoreBefore: boolean;
-      };
-    };
-  } | null;
-};
-
-/**
- * Get passages around a specific passage UUID.
- *
- * NOTE: maxCharacters is not supported by the GraphQL API yet.
- * This parameter is accepted for API compatibility but is ignored.
- */
-export async function getTranslationPassagesAround({
-  client,
-  uuid,
-  passageUuid,
-  type,
-  maxPassages,
-  maxCharacters: _maxCharacters,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-  passageUuid: string;
-  type?: BodyItemType;
-  maxPassages?: number;
-  maxCharacters?: number;
-}): Promise<PassagesPage> {
-  try {
-    const response = await client.request<GetPassagesAroundResponse>(
-      GET_PASSAGES_AROUND,
-      {
-        uuid,
-        cursor: passageUuid,
-        limit: maxPassages,
-        filter: type ? { type } : undefined,
-      },
-    );
-
-    if (!response.work) {
-      return {
-        passages: [],
-        hasMoreAfter: false,
-        hasMoreBefore: false,
-      };
-    }
-
-    return passagesPageFromGraphQL(response.work.passages, response.work.uuid);
-  } catch (error) {
-    console.error('Error fetching translation passages around:', error);
-    return {
-      passages: [],
-      hasMoreAfter: false,
-      hasMoreBefore: false,
-    };
-  }
-}

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

@@ -1,168 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-import type {
-  BodyItemType,
-  PaginationDirection,
-  PassagesPage,
-} from '@eightyfourthousand/data-access';
-import { passagesPageFromGraphQL } from '../mappers';
-
-const GET_PASSAGES = gql`
-  fragment AnnotationFields on Annotation {
-    uuid
-    type
-    start
-    end
-    metadata
-  }
-
-  fragment AlignmentFields on Alignment {
-    folioUuid
-    toh
-    tibetan
-    folioNumber
-    volumeNumber
-  }
-
-  fragment PassageWithAnnotations on Passage {
-    uuid
-    workUuid
-    content
-    label
-    sort
-    type
-    xmlId
-    annotations {
-      ...AnnotationFields
-    }
-    alignments {
-      ...AlignmentFields
-    }
-  }
-
-  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
-        }
-      }
-    }
-  }
-`;
-
-type GetPassagesResponse = {
-  work: {
-    uuid: string;
-    passages: {
-      nodes: Array<{
-        uuid: string;
-        workUuid: string;
-        content: string;
-        label: string;
-        sort: number;
-        type: string;
-        xmlId?: string | null;
-        annotations: Array<{
-          uuid: string;
-          type: string;
-          start: number;
-          end: number;
-          metadata?: Record<string, unknown> | null;
-        }>;
-        alignments: Array<{
-          folioUuid: string;
-          toh: string;
-          tibetan: string;
-          folioNumber: number;
-          volumeNumber: number;
-        }>;
-      }>;
-      pageInfo: {
-        nextCursor?: string | null;
-        prevCursor?: string | null;
-        hasMoreAfter: boolean;
-        hasMoreBefore: boolean;
-      };
-    };
-  } | null;
-};
-
-/**
- * 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 passages for a translation work.
- *
- * NOTE: maxCharacters is not supported by the GraphQL API yet.
- * This parameter is accepted for API compatibility but is ignored.
- */
-export async function getTranslationPassages({
-  client,
-  uuid,
-  type,
-  cursor,
-  maxPassages = 100,
-  maxCharacters: _maxCharacters,
-  direction,
-}: {
-  client: GraphQLClient;
-  uuid: string;
-  type?: BodyItemType;
-  cursor?: string;
-  maxPassages?: number;
-  maxCharacters?: number;
-  direction?: PaginationDirection;
-}): Promise<PassagesPage> {
-  try {
-    const response = await client.request<GetPassagesResponse>(GET_PASSAGES, {
-      uuid,
-      cursor,
-      limit: maxPassages,
-      direction: mapDirection(direction),
-      filter: type ? { type } : undefined,
-    });
-
-    if (!response.work) {
-      return {
-        passages: [],
-        hasMoreAfter: false,
-        hasMoreBefore: false,
-      };
-    }
-
-    return passagesPageFromGraphQL(response.work.passages, response.work.uuid);
-  } catch (error) {
-    console.error('Error fetching translation passages:', error);
-    return {
-      passages: [],
-      hasMoreAfter: false,
-      hasMoreBefore: false,
-    };
-  }
-}

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 [];
-  }
-}

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

@@ -1,63 +0,0 @@
-import type { GraphQLClient } from 'graphql-request';
-import { gql } from 'graphql-request';
-
-const DEFAULT_PAGE_SIZE = 200;
-
-const GET_WORK_UUIDS = gql`
-  query GetWorkUuids($cursor: String, $limit: Int, $filter: WorkFilter) {
-    works(cursor: $cursor, limit: $limit, filter: $filter) {
-      items {
-        uuid
-      }
-      pageInfo {
-        nextCursor
-        hasMoreAfter
-      }
-    }
-  }
-`;
-
-type GetWorkUuidsResponse = {
-  works: {
-    items: Array<{ uuid: string }>;
-    pageInfo: {
-      nextCursor: string | null;
-      hasMoreAfter: boolean;
-    };
-  };
-};
-
-type WorkFilter = {
-  maxPages?: number;
-};
-
-/**
- * Get work UUIDs with optional filtering.
- * @param client - GraphQL client
- * @param filter - Optional filter criteria (e.g., maxPages)
- * @param limit - Optional limit on total results (fetches all pages if not specified)
- */
-export async function getTranslationUuids({
-  client,
-  filter,
-  limit,
-}: {
-  client: GraphQLClient;
-  filter?: WorkFilter;
-  limit?: number;
-}): Promise<string[]> {
-  try {
-    // Single request - no pagination needed for static params
-    const response: GetWorkUuidsResponse =
-      await client.request<GetWorkUuidsResponse>(GET_WORK_UUIDS, {
-        cursor: null,
-        limit: limit ?? DEFAULT_PAGE_SIZE,
-        filter,
-      });
-
-    return response.works.items.map((w) => w.uuid);
-  } catch (error) {
-    console.error('Error fetching translation UUIDs:', error);
-    return [];
-  }
-}