@eightyfourthousand/client-graphql 2026.3.1 → 2026.4.1

package/lib/functions/get-work-glossary-terms.d.ts

@@ -0,0 +1,24 @@
+import type { GraphQLClient } from 'graphql-request';
+import type { GlossaryTermInstance, PaginationDirection } from '@eightyfourthousand/data-access';
+/**
+ * Result of fetching glossary terms with pagination info
+ */
+export type GlossaryTermsPage = {
+    terms: GlossaryTermInstance[];
+    nextCursor?: string;
+    prevCursor?: string;
+    hasMoreAfter: boolean;
+    hasMoreBefore: boolean;
+    totalCount: number;
+};
+/**
+ * Get paginated glossary terms for a work.
+ */
+export declare function getWorkGlossaryTerms({ client, uuid, cursor, limit, direction, withAttestations, }: {
+    client: GraphQLClient;
+    uuid: string;
+    cursor?: string;
+    limit?: number;
+    direction?: PaginationDirection;
+    withAttestations?: boolean;
+}): Promise<GlossaryTermsPage>;

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

@@ -0,0 +1,104 @@
+import { __awaiter } from "tslib";
+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 function getWorkGlossaryTerms(_a) {
+    return __awaiter(this, arguments, void 0, function* ({ client, uuid, cursor, limit = 50, direction, withAttestations = false, }) {
+        var _b, _c;
+        try {
+            const response = yield 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: (_b = glossaryTerms.pageInfo.nextCursor) !== null && _b !== void 0 ? _b : undefined,
+                prevCursor: (_c = glossaryTerms.pageInfo.prevCursor) !== null && _c !== void 0 ? _c : 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,UAAgB,oBAAoB;yDAAC,EACzC,MAAM,EACN,IAAI,EACJ,MAAM,EACN,KAAK,GAAG,EAAE,EACV,SAAS,EACT,gBAAgB,GAAG,KAAK,GAQzB;;QACC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,uBAAuB,EACvB;gBACE,IAAI;gBACJ,MAAM;gBACN,KAAK;gBACL,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC;gBAClC,gBAAgB;aACjB,CACF,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,OAAO;oBACL,KAAK,EAAE,EAAE;oBACT,YAAY,EAAE,KAAK;oBACnB,aAAa,EAAE,KAAK;oBACpB,UAAU,EAAE,CAAC;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,aAAa,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;YAExC,OAAO;gBACL,KAAK,EAAE,aAAa,CAAC,KAAK;gBAC1B,UAAU,EAAE,MAAA,aAAa,CAAC,QAAQ,CAAC,UAAU,mCAAI,SAAS;gBAC1D,UAAU,EAAE,MAAA,aAAa,CAAC,QAAQ,CAAC,UAAU,mCAAI,SAAS;gBAC1D,YAAY,EAAE,aAAa,CAAC,QAAQ,CAAC,YAAY;gBACjD,aAAa,EAAE,aAAa,CAAC,QAAQ,CAAC,aAAa;gBACnD,UAAU,EAAE,aAAa,CAAC,UAAU;aACrC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;YAC5D,OAAO;gBACL,KAAK,EAAE,EAAE;gBACT,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,KAAK;gBACpB,UAAU,EAAE,CAAC;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CAAA"}

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,15 @@
+import { __awaiter } from "tslib";
+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 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ client, permission, }) {
+    const response = yield 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,KAMR,EAAE,4CANa,EAClC,MAAM,EACN,UAAU,GAIX;IACC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,oBAAoB,EACpB,EAAE,UAAU,EAAE,CACf,CAAC;IACF,OAAO,QAAQ,CAAC,aAAa,CAAC;AAChC,CAAC,CAAA,CAAC"}

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

@@ -1,33 +1,19 @@
 export { getPassage } from './get-passage';
-export { getTranslationPassages } from './get-translation-passages';
-export { getTranslationPassagesAround } from './get-translation-passages-around';
-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 { getGlossaryTerms } from './get-glossary-terms';
-export { getGlossaryEntry } from './get-glossary-entry';
 export { getGlossaryInstance } from './get-glossary-instance';
-export { getWorkGlossary } from './get-work-glossary';
-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';
 export { getWorkBibliography } from './get-work-bibliography';
 export { getWorkFolios } from './get-work-folios';
-export { getWorks, type WorksPage } from './get-works';
 export { hasPermission, type Permission } from './has-permission';
+export { replace, type ReplaceType, type ReplacedPassage } from './replace';
 export { savePassages } from './save-passages';

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,49 @@
+import { __awaiter } from "tslib";
+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 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ client, cursorPassageUuid, cursorStart, occurrenceIndex, replaceText, searchText, targetUuids, type = 'PASSAGE', }) {
+    const response = yield 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,KAkBpB,EAAE,4CAlByB,EAC5B,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,IAAI,GAAG,SAAS,GAUjB;IACC,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,CAAA,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,35 @@
+import { __awaiter } from "tslib";
+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 = (_a) => __awaiter(void 0, [_a], void 0, function* ({ client, passages, deletedUuids, }) {
+    const passageInputs = passages.map(passageToInput);
+    const response = yield 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,KAazB,EAAE,4CAb8B,EACjC,MAAM,EACN,QAAQ,EACR,YAAY,GAKb;IAMC,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,CAAA,CAAC"}