@eightyfourthousand/client-graphql 2026.4.0 → 2026.4.2

package/index.d.ts

@@ -0,0 +1,4 @@
+export { createGraphQLClient, resetGraphQLClient, setAccessTokenProvider, } from './lib/client';
+export { getPassage, getTranslationBlocks, getTranslationBlocksAround, getTranslationTitles, getTranslationMetadataByUuid, getTranslationMetadataByToh, getTranslationsMetadata, getTranslationUuids, getTranslationToc, getTranslationImprint, getGlossaryInstance, getWorkGlossaryTerms, getWorkGlossaryTermsAround, type GlossaryTermsPage, getTermPassages, type GlossaryPassagesPage, getBibliographyEntry, getWorkBibliography, getWorkFolios, hasPermission, replace, savePassages, type TranslationBlocksPage, type Permission, type ReplaceType, type ReplacedPassage, } from './lib/functions';
+export type { Passage, Passages, PassagesPage, PaginationDirection, BodyItemType, Annotation, Annotations, Alignment, Work, Title, Titles, TitleType, Toc, TocEntry, Imprint, GlossaryTermInstance, GlossaryLandingItem, GlossaryPageItem, BibliographyEntry, BibliographyEntryItem, BibliographyEntries, Folio, } from '@eightyfourthousand/data-access';
+export { BODY_ITEM_TYPES, FRONT_MATTER, FRONT_MATTER_FILTER, BODY_MATTER, BODY_MATTER_FILTER, BACK_MATTER, BACK_MATTER_FILTER, COMPARE_MODE, COMPARE_MODE_FILTER, } from '@eightyfourthousand/data-access';

package/index.js

@@ -0,0 +1,7 @@
+// Client
+export { createGraphQLClient, resetGraphQLClient, setAccessTokenProvider, } from './lib/client';
+// Functions
+export { getPassage, getTranslationBlocks, getTranslationBlocksAround, getTranslationTitles, getTranslationMetadataByUuid, getTranslationMetadataByToh, getTranslationsMetadata, getTranslationUuids, getTranslationToc, getTranslationImprint, getGlossaryInstance, getWorkGlossaryTerms, getWorkGlossaryTermsAround, getTermPassages, getBibliographyEntry, getWorkBibliography, getWorkFolios, hasPermission, replace, savePassages, } from './lib/functions';
+// Re-export constants for passage filters
+export { BODY_ITEM_TYPES, FRONT_MATTER, FRONT_MATTER_FILTER, BODY_MATTER, BODY_MATTER_FILTER, BACK_MATTER, BACK_MATTER_FILTER, COMPARE_MODE, COMPARE_MODE_FILTER, } from '@eightyfourthousand/data-access';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../libs/client-graphql/src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,YAAY;AACZ,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAE1B,eAAe,EAEf,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,OAAO,EACP,YAAY,GAKb,MAAM,iBAAiB,CAAC;AA4BzB,0CAA0C;AAC1C,OAAO,EACL,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,GACpB,MAAM,iCAAiC,CAAC"}

package/lib/client-ssr.d.ts

@@ -0,0 +1,16 @@
+import 'server-only';
+import { GraphQLClient } from 'graphql-request';
+/**
+ * Create a GraphQL client for server-side requests (SSR/RSC).
+ * Reads auth cookies from the request and forwards them to the GraphQL API.
+ *
+ * Must be called within a Server Component or Server Action context.
+ */
+export declare function createServerGraphQLClient(): Promise<GraphQLClient>;
+/**
+ * Create a GraphQL client for build-time requests (generateStaticParams).
+ * Does not use cookies since there's no request context during builds.
+ *
+ * Use this in generateStaticParams and other build-time contexts.
+ */
+export declare function createBuildGraphQLClient(): GraphQLClient;

package/lib/client-ssr.js

@@ -0,0 +1,39 @@
+import 'server-only';
+import { GraphQLClient } from 'graphql-request';
+import { cookies } from 'next/headers';
+import { getGraphQLUrl } from './config';
+/**
+ * Create a GraphQL client for server-side requests (SSR/RSC).
+ * Reads auth cookies from the request and forwards them to the GraphQL API.
+ *
+ * Must be called within a Server Component or Server Action context.
+ */
+export async function createServerGraphQLClient() {
+    const url = getGraphQLUrl();
+    // Get all cookies from the request
+    const cookieStore = await cookies();
+    const allCookies = cookieStore.getAll();
+    // Build cookie header string with encoded values to ensure HTTP header compatibility
+    // Cookie values may contain non-ASCII characters which are invalid in HTTP headers (ByteString)
+    const cookieHeader = allCookies
+        .map((cookie) => `${cookie.name}=${encodeURIComponent(cookie.value)}`)
+        .join('; ');
+    const client = new GraphQLClient(url, {
+        headers: {
+            // Forward cookies for authentication
+            ...(cookieHeader ? { cookie: cookieHeader } : {}),
+        },
+    });
+    return client;
+}
+/**
+ * Create a GraphQL client for build-time requests (generateStaticParams).
+ * Does not use cookies since there's no request context during builds.
+ *
+ * Use this in generateStaticParams and other build-time contexts.
+ */
+export function createBuildGraphQLClient() {
+    const url = getGraphQLUrl();
+    return new GraphQLClient(url);
+}
+//# sourceMappingURL=client-ssr.js.map

package/lib/client-ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-ssr.js","sourceRoot":"","sources":["../../../../libs/client-graphql/src/lib/client-ssr.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAE5B,mCAAmC;IACnC,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;IAExC,qFAAqF;IACrF,gGAAgG;IAChG,MAAM,YAAY,GAAG,UAAU;SAC5B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;SACrE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,EAAE;QACpC,OAAO,EAAE;YACP,qCAAqC;YACrC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,OAAO,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/lib/client.d.ts

@@ -0,0 +1,15 @@
+import { GraphQLClient } from 'graphql-request';
+/**
+ * Set the access token provider function.
+ * This should be called once at app initialization.
+ */
+export declare function setAccessTokenProvider(provider: () => Promise<string | null>): void;
+/**
+ * Create a GraphQL client for browser-side requests.
+ * Uses Authorization header with dynamic token retrieval for cross-domain requests.
+ */
+export declare function createGraphQLClient(): GraphQLClient;
+/**
+ * Reset the client instance (useful for testing)
+ */
+export declare function resetGraphQLClient(): void;

package/lib/client.js

@@ -0,0 +1,48 @@
+import { GraphQLClient } from 'graphql-request';
+import { getGraphQLUrl } from './config';
+let clientInstance = null;
+let getAccessToken = null;
+/**
+ * Set the access token provider function.
+ * This should be called once at app initialization.
+ */
+export function setAccessTokenProvider(provider) {
+    getAccessToken = provider;
+}
+/**
+ * Create a GraphQL client for browser-side requests.
+ * Uses Authorization header with dynamic token retrieval for cross-domain requests.
+ */
+export function createGraphQLClient() {
+    if (clientInstance) {
+        return clientInstance;
+    }
+    const url = getGraphQLUrl();
+    clientInstance = new GraphQLClient(url, {
+        // Dynamic headers - called on each request
+        requestMiddleware: async (request) => {
+            const headers = {
+                'Content-Type': 'application/json',
+                'apollo-require-preflight': 'true',
+            };
+            if (getAccessToken) {
+                const token = await getAccessToken();
+                if (token) {
+                    headers['Authorization'] = `Bearer ${token}`;
+                }
+            }
+            return {
+                ...request,
+                headers,
+            };
+        },
+    });
+    return clientInstance;
+}
+/**
+ * Reset the client instance (useful for testing)
+ */
+export function resetGraphQLClient() {
+    clientInstance = null;
+}
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../libs/client-graphql/src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,cAAc,GAAyB,IAAI,CAAC;AAChD,IAAI,cAAc,GAA0C,IAAI,CAAC;AAEjE;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAsC;IAEtC,cAAc,GAAG,QAAQ,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAE5B,cAAc,GAAG,IAAI,aAAa,CAAC,GAAG,EAAE;QACtC,2CAA2C;QAC3C,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACnC,MAAM,OAAO,GAA2B;gBACtC,cAAc,EAAE,kBAAkB;gBAClC,0BAA0B,EAAE,MAAM;aACnC,CAAC;YAEF,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;gBACrC,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;gBAC/C,CAAC;YACH,CAAC;YAED,OAAO;gBACL,GAAG,OAAO;gBACV,OAAO;aACR,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/lib/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GraphQL API configuration
+ */
+/**
+ * Get the GraphQL API URL from environment variables
+ * Falls back to localhost for development
+ */
+export declare function getGraphQLUrl(): string;

package/lib/config.js

@@ -0,0 +1,19 @@
+/**
+ * GraphQL API configuration
+ */
+/**
+ * Get the GraphQL API URL from environment variables
+ * Falls back to localhost for development
+ */
+export function getGraphQLUrl() {
+    const url = process.env.NEXT_PUBLIC_GRAPHQL_URL;
+    if (!url) {
+        // Default to localhost in development
+        if (process.env.NODE_ENV === 'development') {
+            return 'http://localhost:3001/api/graphql';
+        }
+        throw new Error('NEXT_PUBLIC_GRAPHQL_URL environment variable is not set');
+    }
+    return url;
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../libs/client-graphql/src/lib/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAEhD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,sCAAsC;QACtC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,OAAO,mCAAmC,CAAC;QAC7C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/functions/get-bibliography-entry.d.ts

@@ -0,0 +1,9 @@
+import type { GraphQLClient } from 'graphql-request';
+import type { BibliographyEntryItem } from '@eightyfourthousand/data-access';
+/**
+ * Get a single bibliography entry by UUID.
+ */
+export declare function getBibliographyEntry({ client, uuid, }: {
+    client: GraphQLClient;
+    uuid: string;
+}): Promise<BibliographyEntryItem | null>;

package/lib/functions/get-bibliography-entry.js

@@ -0,0 +1,24 @@
+import { gql } from 'graphql-request';
+const GET_BIBLIOGRAPHY_ENTRY = gql `
+  query GetBibliographyEntry($uuid: ID!) {
+    bibliographyEntry(uuid: $uuid) {
+      uuid
+      html
+      workUuid
+    }
+  }
+`;
+/**
+ * Get a single bibliography entry by UUID.
+ */
+export async function getBibliographyEntry({ client, uuid, }) {
+    try {
+        const response = await client.request(GET_BIBLIOGRAPHY_ENTRY, { uuid });
+        return response.bibliographyEntry;
+    }
+    catch (error) {
+        console.error('Error fetching bibliography entry:', error);
+        return null;
+    }
+}
+//# sourceMappingURL=get-bibliography-entry.js.map

package/lib/functions/get-bibliography-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-bibliography-entry.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/get-bibliography-entry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAGtC,MAAM,sBAAsB,GAAG,GAAG,CAAA;;;;;;;;CAQjC,CAAC;AAMF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EACN,IAAI,GAIL;IACC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,sBAAsB,EACtB,EAAE,IAAI,EAAE,CACT,CAAC;QAEF,OAAO,QAAQ,CAAC,iBAAiB,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { GraphQLClient } from 'graphql-request';
+import type { GlossaryTermInstance } from '@eightyfourthousand/data-access';
+/**
+ * Get a single glossary instance by UUID.
+ */
+export declare function getGlossaryInstance({ client, uuid, }: {
+    client: GraphQLClient;
+    uuid: string;
+}): Promise<GlossaryTermInstance | null>;

package/lib/functions/get-glossary-instance.js

@@ -0,0 +1,33 @@
+import { gql } from 'graphql-request';
+const GET_GLOSSARY_INSTANCE = gql `
+  query GetGlossaryInstance($uuid: ID!) {
+    glossaryInstance(uuid: $uuid) {
+      uuid
+      authority
+      definition
+      names {
+        english
+        tibetan
+        sanskrit
+        pali
+        chinese
+        wylie
+        alternatives
+      }
+    }
+  }
+`;
+/**
+ * Get a single glossary instance by UUID.
+ */
+export async function getGlossaryInstance({ client, uuid, }) {
+    try {
+        const response = await client.request(GET_GLOSSARY_INSTANCE, { uuid });
+        return response.glossaryInstance;
+    }
+    catch (error) {
+        console.error('Error fetching glossary instance:', error);
+        return null;
+    }
+}
+//# sourceMappingURL=get-glossary-instance.js.map

package/lib/functions/get-glossary-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-glossary-instance.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/get-glossary-instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAGtC,MAAM,qBAAqB,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;CAiBhC,CAAC;AAMF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACxC,MAAM,EACN,IAAI,GAIL;IACC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,qBAAqB,EACrB,EAAE,IAAI,EAAE,CACT,CAAC;QAEF,OAAO,QAAQ,CAAC,gBAAgB,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { GraphQLClient } from 'graphql-request';
+import type { Passage } from '@eightyfourthousand/data-access';
+/**
+ * Get a single passage by UUID or XML ID.
+ */
+export declare function getPassage({ client, uuid, xmlId, }: {
+    client: GraphQLClient;
+    uuid?: string;
+    xmlId?: string;
+}): Promise<Passage | undefined>;

package/lib/functions/get-passage.js

@@ -0,0 +1,65 @@
+import { gql } from 'graphql-request';
+import { passageFromGraphQL } 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
+    }
+  }
+`;
+/**
+ * Get a single passage by UUID or XML ID.
+ */
+export async function getPassage({ client, uuid, xmlId, }) {
+    try {
+        const response = await client.request(GET_PASSAGE, {
+            uuid,
+            xmlId,
+        });
+        if (!response.passage) {
+            return undefined;
+        }
+        return passageFromGraphQL(response.passage);
+    }
+    catch (error) {
+        console.error('Error fetching passage:', error);
+        return undefined;
+    }
+}
+//# sourceMappingURL=get-passage.js.map

package/lib/functions/get-passage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-passage.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/get-passage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAuB,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CtB,CAAC;AAMF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAC/B,MAAM,EACN,IAAI,EACJ,KAAK,GAKN;IACC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAqB,WAAW,EAAE;YACrE,IAAI;YACJ,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { GraphQLClient } from 'graphql-request';
+export type GlossaryPassagesPage = {
+    items: Array<{
+        uuid: string;
+        type: string;
+        label: string;
+        sort: number;
+    }>;
+    nextCursor: string | null;
+    hasMore: boolean;
+};
+/**
+ * Fetch a page of passage references for a single glossary term instance.
+ */
+export declare function getTermPassages({ client, uuid, first, after, }: {
+    client: GraphQLClient;
+    uuid: string;
+    first?: number;
+    after?: string;
+}): Promise<GlossaryPassagesPage>;

package/lib/functions/get-term-passages.js

@@ -0,0 +1,29 @@
+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
+    }
+  }
+`;
+/**
+ * Fetch a page of passage references for a single glossary term instance.
+ */
+export async function getTermPassages({ client, uuid, first = 10, after, }) {
+    try {
+        const response = await client.request(GET_TERM_PASSAGES, { uuid, first, after });
+        return response.glossaryTermPassages;
+    }
+    catch (error) {
+        console.error('Error fetching term passages:', error);
+        return { items: [], nextCursor: null, hasMore: false };
+    }
+}
+//# sourceMappingURL=get-term-passages.js.map

package/lib/functions/get-term-passages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-term-passages.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/get-term-passages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,MAAM,iBAAiB,GAAG,GAAG,CAAA;;;;;;;;;;;;;CAa5B,CAAC;AAYF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EACpC,MAAM,EACN,IAAI,EACJ,KAAK,GAAG,EAAE,EACV,KAAK,GAMN;IACC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,iBAAiB,EACjB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CACvB,CAAC;QACF,OAAO,QAAQ,CAAC,oBAAoB,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACzD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { GraphQLClient } from 'graphql-request';
+import type { BodyItemType } from '@eightyfourthousand/data-access';
+import type { TranslationBlocksPage } from './get-translation-blocks';
+/**
+ * Get translation blocks (TipTap JSON) around a specific passage UUID.
+ *
+ * Returns pre-transformed TipTap editor blocks ready for rendering.
+ */
+export declare function getTranslationBlocksAround({ client, uuid, passageUuid, type, maxPassages, }: {
+    client: GraphQLClient;
+    uuid: string;
+    passageUuid: string;
+    type?: BodyItemType | string;
+    maxPassages?: number;
+}): Promise<TranslationBlocksPage>;

package/lib/functions/get-translation-blocks-around.js

@@ -0,0 +1,82 @@
+import { gql } from 'graphql-request';
+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
+        }
+      }
+    }
+  }
+`;
+/**
+ * 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, }) {
+    try {
+        const response = await client.request(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 != 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,
+        };
+    }
+}
+//# sourceMappingURL=get-translation-blocks-around.js.map

package/lib/functions/get-translation-blocks-around.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-translation-blocks-around.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/get-translation-blocks-around.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAItC,MAAM,6BAA6B,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCxC,CAAC;AA2BF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,EAC/C,MAAM,EACN,IAAI,EACJ,WAAW,EACX,IAAI,EACJ,WAAW,GAOZ;IACC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,6BAA6B,EAC7B;YACE,IAAI;YACJ,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,WAAW;YAClB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;SACpC,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,KAAK;aACrB,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;QAEnC,yDAAyD;QACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK;aAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;aACxB,MAAM,CAAC,CAAC,IAAI,EAAwC,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;QAExE,OAAO;YACL,MAAM;YACN,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,IAAI,SAAS;YACrD,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,IAAI,SAAS;YACrD,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY;YAC5C,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;SAC/C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;QAClE,OAAO;YACL,MAAM,EAAE,EAAE;YACV,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { GraphQLClient } from 'graphql-request';
+import type { BodyItemType, PaginationDirection, TranslationEditorContent } from '@eightyfourthousand/data-access';
+/**
+ * Result of fetching translation blocks with pagination info
+ */
+export type TranslationBlocksPage = {
+    blocks: TranslationEditorContent;
+    nextCursor?: string;
+    prevCursor?: string;
+    hasMoreAfter: boolean;
+    hasMoreBefore: boolean;
+};
+/**
+ * Get paginated translation blocks (TipTap JSON) for a work.
+ *
+ * Returns pre-transformed TipTap editor blocks ready for rendering.
+ */
+export declare function getTranslationBlocks({ client, uuid, type, cursor, maxPassages, direction, }: {
+    client: GraphQLClient;
+    uuid: string;
+    type?: BodyItemType | string;
+    cursor?: string;
+    maxPassages?: number;
+    direction?: PaginationDirection;
+}): Promise<TranslationBlocksPage>;

package/lib/functions/get-translation-blocks.js

@@ -0,0 +1,92 @@
+import { gql } from 'graphql-request';
+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
+        }
+      }
+    }
+  }
+`;
+/**
+ * Map internal pagination direction to GraphQL enum
+ */
+function mapDirection(direction) {
+    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, }) {
+    try {
+        const response = await client.request(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 != 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,
+        };
+    }
+}
+//# sourceMappingURL=get-translation-blocks.js.map

package/lib/functions/get-translation-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-translation-blocks.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/get-translation-blocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAQtC,MAAM,sBAAsB,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCjC,CAAC;AAsCF;;GAEG;AACH,SAAS,YAAY,CACnB,SAA+B;IAE/B,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,WAAW,GAAG,GAAG,EACjB,SAAS,GAQV;IACC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,sBAAsB,EACtB;YACE,IAAI;YACJ,MAAM;YACN,KAAK,EAAE,WAAW;YAClB,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC;YAClC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;SACpC,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,KAAK;aACrB,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;QAEnC,yDAAyD;QACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK;aAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;aACxB,MAAM,CAAC,CAAC,IAAI,EAAwC,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;QAExE,OAAO;YACL,MAAM;YACN,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,IAAI,SAAS;YACrD,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,IAAI,SAAS;YACrD,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY;YAC5C,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;SAC/C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO;YACL,MAAM,EAAE,EAAE;YACV,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { GraphQLClient } from 'graphql-request';
+import type { Imprint } from '@eightyfourthousand/data-access';
+/**
+ * Get the imprint for a translation work.
+ */
+export declare function getTranslationImprint({ client, uuid, toh, }: {
+    client: GraphQLClient;
+    uuid: string;
+    toh: string;
+}): Promise<Imprint | undefined>;