@eightyfourthousand/client-graphql 2026.4.0 → 2026.4.2

package/lib/functions/get-work-glossary-terms.js

@@ -0,0 +1,100 @@
+import { gql } from 'graphql-request';
+const GET_WORK_GLOSSARY_TERMS = gql `
+  query GetWorkGlossaryTerms(
+    $uuid: ID!
+    $cursor: String
+    $limit: Int
+    $direction: PaginationDirection
+    $withAttestations: Boolean
+  ) {
+    work(uuid: $uuid) {
+      glossaryTerms(
+        cursor: $cursor
+        limit: $limit
+        direction: $direction
+        withAttestations: $withAttestations
+      ) {
+        nodes {
+          uuid
+          authority
+          definition
+          termNumber
+          names {
+            english
+            tibetan
+            sanskrit
+            pali
+            chinese
+            wylie
+            alternatives
+          }
+          passages(first: 10) {
+            items {
+              uuid
+              type
+              label
+            }
+            nextCursor
+            hasMore
+          }
+        }
+        pageInfo {
+          nextCursor
+          prevCursor
+          hasMoreAfter
+          hasMoreBefore
+        }
+        totalCount
+      }
+    }
+  }
+`;
+/**
+ * Map internal pagination direction to GraphQL enum
+ */
+function mapDirection(direction) {
+    if (!direction)
+        return undefined;
+    return direction === 'forward' ? 'FORWARD' : 'BACKWARD';
+}
+/**
+ * Get paginated glossary terms for a work.
+ */
+export async function getWorkGlossaryTerms({ client, uuid, cursor, limit = 50, direction, withAttestations = false, }) {
+    try {
+        const response = await client.request(GET_WORK_GLOSSARY_TERMS, {
+            uuid,
+            cursor,
+            limit,
+            direction: mapDirection(direction),
+            withAttestations,
+        });
+        if (!response.work) {
+            return {
+                terms: [],
+                hasMoreAfter: false,
+                hasMoreBefore: false,
+                totalCount: 0,
+            };
+        }
+        const { glossaryTerms } = response.work;
+        return {
+            terms: glossaryTerms.nodes,
+            nextCursor: glossaryTerms.pageInfo.nextCursor ?? undefined,
+            prevCursor: glossaryTerms.pageInfo.prevCursor ?? undefined,
+            hasMoreAfter: glossaryTerms.pageInfo.hasMoreAfter,
+            hasMoreBefore: glossaryTerms.pageInfo.hasMoreBefore,
+            totalCount: glossaryTerms.totalCount,
+        };
+    }
+    catch (error) {
+        console.error('Error fetching work glossary terms:', error);
+        return {
+            terms: [],
+            hasMoreAfter: false,
+            hasMoreBefore: false,
+            totalCount: 0,
+        };
+    }
+}
+//# sourceMappingURL=get-work-glossary-terms.js.map

package/lib/functions/get-work-glossary-terms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-work-glossary-terms.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/get-work-glossary-terms.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAMtC,MAAM,uBAAuB,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDlC,CAAC;AA6BF;;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;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EACN,IAAI,EACJ,MAAM,EACN,KAAK,GAAG,EAAE,EACV,SAAS,EACT,gBAAgB,GAAG,KAAK,GAQzB;IACC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,uBAAuB,EACvB;YACE,IAAI;YACJ,MAAM;YACN,KAAK;YACL,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC;YAClC,gBAAgB;SACjB,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO;gBACL,KAAK,EAAE,EAAE;gBACT,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,KAAK;gBACpB,UAAU,EAAE,CAAC;aACd,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,aAAa,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;QAExC,OAAO;YACL,KAAK,EAAE,aAAa,CAAC,KAAK;YAC1B,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,UAAU,IAAI,SAAS;YAC1D,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,UAAU,IAAI,SAAS;YAC1D,YAAY,EAAE,aAAa,CAAC,QAAQ,CAAC,YAAY;YACjD,aAAa,EAAE,aAAa,CAAC,QAAQ,CAAC,aAAa;YACnD,UAAU,EAAE,aAAa,CAAC,UAAU;SACrC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO;YACL,KAAK,EAAE,EAAE;YACT,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;YACpB,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/functions/has-permission.d.ts

@@ -0,0 +1,9 @@
+import type { GraphQLClient } from 'graphql-request';
+export type Permission = 'PROJECTS_READ' | 'PROJECTS_EDIT' | 'PROJECTS_ADMIN' | 'EDITOR_READ' | 'EDITOR_EDIT' | 'EDITOR_ADMIN';
+/**
+ * Check if the current user has a specific permission
+ */
+export declare const hasPermission: ({ client, permission, }: {
+    client: GraphQLClient;
+    permission: Permission;
+}) => Promise<boolean>;

package/lib/functions/has-permission.js

@@ -0,0 +1,14 @@
+import { gql } from 'graphql-request';
+const HAS_PERMISSION_QUERY = gql `
+  query HasPermission($permission: Permission!) {
+    hasPermission(permission: $permission)
+  }
+`;
+/**
+ * Check if the current user has a specific permission
+ */
+export const hasPermission = async ({ client, permission, }) => {
+    const response = await client.request(HAS_PERMISSION_QUERY, { permission });
+    return response.hasPermission;
+};
+//# sourceMappingURL=has-permission.js.map

package/lib/functions/has-permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-permission.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/has-permission.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAWtC,MAAM,oBAAoB,GAAG,GAAG,CAAA;;;;CAI/B,CAAC;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,EAClC,MAAM,EACN,UAAU,GAIX,EAAoB,EAAE;IACrB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,oBAAoB,EACpB,EAAE,UAAU,EAAE,CACf,CAAC;IACF,OAAO,QAAQ,CAAC,aAAa,CAAC;AAChC,CAAC,CAAC"}

package/{src/lib/functions/index.ts → lib/functions/index.d.ts}

@@ -1,23 +1,14 @@
 export { getPassage } from './get-passage';
-export {
-  getTranslationBlocks,
-  type TranslationBlocksPage,
-} from './get-translation-blocks';
+export { getTranslationBlocks, type TranslationBlocksPage, } from './get-translation-blocks';
 export { getTranslationBlocksAround } from './get-translation-blocks-around';
 export { getTranslationTitles } from './get-translation-titles';
-export {
-  getTranslationMetadataByUuid,
-  getTranslationMetadataByToh,
-} from './get-translation-metadata';
+export { getTranslationMetadataByUuid, getTranslationMetadataByToh, } from './get-translation-metadata';
 export { getTranslationsMetadata } from './get-translations-metadata';
 export { getTranslationUuids } from './get-translation-uuids';
 export { getTranslationToc } from './get-translation-toc';
 export { getTranslationImprint } from './get-translation-imprint';
 export { getGlossaryInstance } from './get-glossary-instance';
-export {
-  getWorkGlossaryTerms,
-  type GlossaryTermsPage,
-} from './get-work-glossary-terms';
+export { getWorkGlossaryTerms, type GlossaryTermsPage, } from './get-work-glossary-terms';
 export { getWorkGlossaryTermsAround } from './get-work-glossary-terms-around';
 export { getTermPassages, type GlossaryPassagesPage } from './get-term-passages';
 export { getBibliographyEntry } from './get-bibliography-entry';

package/lib/functions/index.js

@@ -0,0 +1,20 @@
+export { getPassage } from './get-passage';
+export { getTranslationBlocks, } from './get-translation-blocks';
+export { getTranslationBlocksAround } from './get-translation-blocks-around';
+export { getTranslationTitles } from './get-translation-titles';
+export { getTranslationMetadataByUuid, getTranslationMetadataByToh, } from './get-translation-metadata';
+export { getTranslationsMetadata } from './get-translations-metadata';
+export { getTranslationUuids } from './get-translation-uuids';
+export { getTranslationToc } from './get-translation-toc';
+export { getTranslationImprint } from './get-translation-imprint';
+export { getGlossaryInstance } from './get-glossary-instance';
+export { getWorkGlossaryTerms, } from './get-work-glossary-terms';
+export { getWorkGlossaryTermsAround } from './get-work-glossary-terms-around';
+export { getTermPassages } from './get-term-passages';
+export { getBibliographyEntry } from './get-bibliography-entry';
+export { getWorkBibliography } from './get-work-bibliography';
+export { getWorkFolios } from './get-work-folios';
+export { hasPermission } from './has-permission';
+export { replace } from './replace';
+export { savePassages } from './save-passages';
+//# sourceMappingURL=index.js.map

package/lib/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EACL,oBAAoB,GAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,oBAAoB,GAErB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAA6B,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAmB,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,OAAO,EAA0C,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/functions/replace.d.ts

@@ -0,0 +1,27 @@
+import type { GraphQLClient } from 'graphql-request';
+import type { TranslationEditorContentItem } from '@eightyfourthousand/data-access';
+export type ReplaceType = 'PASSAGE';
+export interface ReplacedPassage {
+    json?: TranslationEditorContentItem | null;
+    uuid: string;
+}
+export declare const replace: ({ client, cursorPassageUuid, cursorStart, occurrenceIndex, replaceText, searchText, targetUuids, type, }: {
+    client: GraphQLClient;
+    occurrenceIndex?: number;
+    replaceText: string;
+    searchText: string;
+    cursorPassageUuid?: string;
+    cursorStart?: number;
+    targetUuids: string[];
+    type?: ReplaceType;
+}) => Promise<{
+    deletedAnnotationCount: number;
+    error?: string;
+    nextOccurrenceStart?: number | null;
+    nextPassageUuid?: string | null;
+    passages: ReplacedPassage[];
+    replacedOccurrenceCount: number;
+    success: boolean;
+    updatedAnnotationCount: number;
+    updatedCount: number;
+}>;

package/lib/functions/replace.js

@@ -0,0 +1,48 @@
+import { gql } from 'graphql-request';
+const REPLACE_MUTATION = gql `
+  mutation Replace(
+    $searchText: String!
+    $replaceText: String!
+    $targetUuids: [ID!]!
+    $type: ReplaceType
+    $occurrenceIndex: Int
+    $cursorPassageUuid: ID
+    $cursorStart: Int
+  ) {
+    replace(
+      searchText: $searchText
+      replaceText: $replaceText
+      targetUuids: $targetUuids
+      type: $type
+      occurrenceIndex: $occurrenceIndex
+      cursorPassageUuid: $cursorPassageUuid
+      cursorStart: $cursorStart
+    ) {
+      success
+      updatedCount
+      replacedOccurrenceCount
+      updatedAnnotationCount
+      deletedAnnotationCount
+      nextPassageUuid
+      nextOccurrenceStart
+      error
+      passages {
+        uuid
+        json
+      }
+    }
+  }
+`;
+export const replace = async ({ client, cursorPassageUuid, cursorStart, occurrenceIndex, replaceText, searchText, targetUuids, type = 'PASSAGE', }) => {
+    const response = await client.request(REPLACE_MUTATION, {
+        searchText,
+        replaceText,
+        targetUuids,
+        type,
+        occurrenceIndex,
+        cursorPassageUuid,
+        cursorStart,
+    });
+    return response.replace;
+};
+//# sourceMappingURL=replace.js.map

package/lib/functions/replace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/replace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAwBtC,MAAM,gBAAgB,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC3B,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,EAC5B,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,IAAI,GAAG,SAAS,GAUjB,EAAE,EAAE;IACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAkB,gBAAgB,EAAE;QACvE,UAAU;QACV,WAAW;QACX,WAAW;QACX,IAAI;QACJ,eAAe;QACf,iBAAiB;QACjB,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC,CAAC"}

package/lib/functions/save-passages.d.ts

@@ -0,0 +1,16 @@
+import type { GraphQLClient } from 'graphql-request';
+import type { Passage } from '@eightyfourthousand/data-access';
+/**
+ * Save one or more passages via GraphQL mutation.
+ * Requires editor.edit permission.
+ */
+export declare const savePassages: ({ client, passages, deletedUuids, }: {
+    client: GraphQLClient;
+    passages: Passage[];
+    deletedUuids?: string[];
+}) => Promise<{
+    success: boolean;
+    savedCount: number;
+    deletedCount?: number;
+    error?: string;
+}>;

package/lib/functions/save-passages.js

@@ -0,0 +1,34 @@
+import { gql } from 'graphql-request';
+const SAVE_PASSAGES_MUTATION = gql `
+  mutation SavePassages($passages: [PassageInput!]!, $deletedUuids: [ID!]) {
+    savePassages(passages: $passages, deletedUuids: $deletedUuids) {
+      success
+      savedCount
+      deletedCount
+      error
+    }
+  }
+`;
+/**
+ * Convert a Passage to the GraphQL input format
+ */
+const passageToInput = (passage) => ({
+    uuid: passage.uuid,
+    workUuid: passage.workUuid,
+    content: passage.content,
+    label: passage.label,
+    sort: passage.sort,
+    type: passage.type,
+    xmlId: passage.xmlId,
+    annotations: passage.annotations,
+});
+/**
+ * Save one or more passages via GraphQL mutation.
+ * Requires editor.edit permission.
+ */
+export const savePassages = async ({ client, passages, deletedUuids, }) => {
+    const passageInputs = passages.map(passageToInput);
+    const response = await client.request(SAVE_PASSAGES_MUTATION, { passages: passageInputs, deletedUuids });
+    return response.savePassages;
+};
+//# sourceMappingURL=save-passages.js.map

package/lib/functions/save-passages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-passages.js","sourceRoot":"","sources":["../../../../../libs/client-graphql/src/lib/functions/save-passages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAGtC,MAAM,sBAAsB,GAAG,GAAG,CAAA;;;;;;;;;CASjC,CAAC;AAsBF;;GAEG;AACH,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAgB,EAAE,CAAC,CAAC;IAC1D,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;IACxB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,WAAW,EAAE,OAAO,CAAC,WAAW;CACjC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,EACjC,MAAM,EACN,QAAQ,EACR,YAAY,GAKb,EAKE,EAAE;IACH,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,sBAAsB,EACtB,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,CAC1C,CAAC;IAEF,OAAO,QAAQ,CAAC,YAAY,CAAC;AAC/B,CAAC,CAAC"}