@eightyfourthousand/client-graphql 2026.3.1 → 2026.4.1

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 { __awaiter } from "tslib";
+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 function createServerGraphQLClient() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const url = getGraphQLUrl();
+        // Get all cookies from the request
+        const cookieStore = yield 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: Object.assign({}, (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,UAAgB,yBAAyB;;QAC7C,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;QAE5B,mCAAmC;QACnC,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;QAExC,qFAAqF;QACrF,gGAAgG;QAChG,MAAM,YAAY,GAAG,UAAU;aAC5B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;aACrE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,EAAE;YACpC,OAAO,oBAEF,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAClD;SACF,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CAAA;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,46 @@
+import { __awaiter } from "tslib";
+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: (request) => __awaiter(this, void 0, void 0, function* () {
+            const headers = {
+                'Content-Type': 'application/json',
+                'apollo-require-preflight': 'true',
+            };
+            if (getAccessToken) {
+                const token = yield getAccessToken();
+                if (token) {
+                    headers['Authorization'] = `Bearer ${token}`;
+                }
+            }
+            return Object.assign(Object.assign({}, 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,CAAO,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,uCACK,OAAO,KACV,OAAO,IACP;QACJ,CAAC,CAAA;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,27 @@
+import { __awaiter } from "tslib";
+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 function getBibliographyEntry(_a) {
+    return __awaiter(this, arguments, void 0, function* ({ client, uuid, }) {
+        try {
+            const response = yield 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,UAAgB,oBAAoB;yDAAC,EACzC,MAAM,EACN,IAAI,GAIL;QACC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,sBAAsB,EACtB,EAAE,IAAI,EAAE,CACT,CAAC;YAEF,OAAO,QAAQ,CAAC,iBAAiB,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CAAA"}

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,36 @@
+import { __awaiter } from "tslib";
+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 function getGlossaryInstance(_a) {
+    return __awaiter(this, arguments, void 0, function* ({ client, uuid, }) {
+        try {
+            const response = yield 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,UAAgB,mBAAmB;yDAAC,EACxC,MAAM,EACN,IAAI,GAIL;QACC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,qBAAqB,EACrB,EAAE,IAAI,EAAE,CACT,CAAC;YAEF,OAAO,QAAQ,CAAC,gBAAgB,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CAAA"}

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,68 @@
+import { __awaiter } from "tslib";
+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 function getPassage(_a) {
+    return __awaiter(this, arguments, void 0, function* ({ client, uuid, xmlId, }) {
+        try {
+            const response = yield 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,UAAgB,UAAU;yDAAC,EAC/B,MAAM,EACN,IAAI,EACJ,KAAK,GAKN;QACC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAqB,WAAW,EAAE;gBACrE,IAAI;gBACJ,KAAK;aACN,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CAAA"}

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,32 @@
+import { __awaiter } from "tslib";
+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 function getTermPassages(_a) {
+    return __awaiter(this, arguments, void 0, function* ({ client, uuid, first = 10, after, }) {
+        try {
+            const response = yield 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,UAAgB,eAAe;yDAAC,EACpC,MAAM,EACN,IAAI,EACJ,KAAK,GAAG,EAAE,EACV,KAAK,GAMN;QACC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,iBAAiB,EACjB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CACvB,CAAC;YACF,OAAO,QAAQ,CAAC,oBAAoB,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YACtD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACzD,CAAC;IACH,CAAC;CAAA"}

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,86 @@
+import { __awaiter } from "tslib";
+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 function getTranslationBlocksAround(_a) {
+    return __awaiter(this, arguments, void 0, function* ({ client, uuid, passageUuid, type, maxPassages, }) {
+        var _b, _c;
+        try {
+            const response = yield 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: (_b = passages.pageInfo.nextCursor) !== null && _b !== void 0 ? _b : undefined,
+                prevCursor: (_c = passages.pageInfo.prevCursor) !== null && _c !== void 0 ? _c : 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,UAAgB,0BAA0B;yDAAC,EAC/C,MAAM,EACN,IAAI,EACJ,WAAW,EACX,IAAI,EACJ,WAAW,GAOZ;;QACC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,6BAA6B,EAC7B;gBACE,IAAI;gBACJ,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,WAAW;gBAClB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;aACpC,CACF,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,OAAO;oBACL,MAAM,EAAE,EAAE;oBACV,YAAY,EAAE,KAAK;oBACnB,aAAa,EAAE,KAAK;iBACrB,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;YAEnC,yDAAyD;YACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK;iBAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;iBACxB,MAAM,CAAC,CAAC,IAAI,EAAwC,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;YAExE,OAAO;gBACL,MAAM;gBACN,UAAU,EAAE,MAAA,QAAQ,CAAC,QAAQ,CAAC,UAAU,mCAAI,SAAS;gBACrD,UAAU,EAAE,MAAA,QAAQ,CAAC,QAAQ,CAAC,UAAU,mCAAI,SAAS;gBACrD,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY;gBAC5C,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;aAC/C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;YAClE,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,KAAK;aACrB,CAAC;QACJ,CAAC;IACH,CAAC;CAAA"}

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,96 @@
+import { __awaiter } from "tslib";
+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 function getTranslationBlocks(_a) {
+    return __awaiter(this, arguments, void 0, function* ({ client, uuid, type, cursor, maxPassages = 100, direction, }) {
+        var _b, _c;
+        try {
+            const response = yield 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: (_b = passages.pageInfo.nextCursor) !== null && _b !== void 0 ? _b : undefined,
+                prevCursor: (_c = passages.pageInfo.prevCursor) !== null && _c !== void 0 ? _c : 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,UAAgB,oBAAoB;yDAAC,EACzC,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,WAAW,GAAG,GAAG,EACjB,SAAS,GAQV;;QACC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,sBAAsB,EACtB;gBACE,IAAI;gBACJ,MAAM;gBACN,KAAK,EAAE,WAAW;gBAClB,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC;gBAClC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;aACpC,CACF,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,OAAO;oBACL,MAAM,EAAE,EAAE;oBACV,YAAY,EAAE,KAAK;oBACnB,aAAa,EAAE,KAAK;iBACrB,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;YAEnC,yDAAyD;YACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK;iBAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;iBACxB,MAAM,CAAC,CAAC,IAAI,EAAwC,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;YAExE,OAAO;gBACL,MAAM;gBACN,UAAU,EAAE,MAAA,QAAQ,CAAC,QAAQ,CAAC,UAAU,mCAAI,SAAS;gBACrD,UAAU,EAAE,MAAA,QAAQ,CAAC,QAAQ,CAAC,UAAU,mCAAI,SAAS;gBACrD,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY;gBAC5C,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;aAC/C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;YAC3D,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,KAAK;aACrB,CAAC;QACJ,CAAC;IACH,CAAC;CAAA"}