@eightyfourthousand/data-access 2026.3.0 → 2026.4.0

package/README.md

@@ -1,6 +1,8 @@
-# data-access
+# @eightyfourthousand/data-access
 
-This library was generated with [Nx](https://nx.dev).
+Shared data-access clients, DTO mappers, and domain types for 84000 applications.
+
+Use this package for typed access to shared application data models and server/client data helpers.
 
 ## Running unit tests
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eightyfourthousand/data-access",
-  "version": "2026.3.0",
+  "version": "2026.4.0",
   "description": "Shared data access clients, DTO mappers, and domain types for 84000 applications.",
   "private": false,
   "repository": {
@@ -17,7 +17,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@eightyfourthousand/lib-utils": "^2026.3.0"
+    "@eightyfourthousand/lib-utils": "^2026.3.1"
   },
   "peerDependencies": {
     "next": "^16.0.0",

package/src/index.ts

@@ -1,6 +1,5 @@
 export * from './lib/auth';
 export * from './lib/bibliography';
-export * from './lib/canon';
 export * from './lib/client-browser';
 export * from './lib/client-server';
 export * from './lib/client-token';
@@ -10,8 +9,8 @@ export * from './lib/imprint';
 export * from './lib/panel-url';
 export * from './lib/library';
 export * from './lib/passage';
-export * from './lib/projects';
 export * from './lib/publications';
+export * from './lib/replace';
 export * from './lib/storage';
 export * from './lib/types';
 export * from './lib/local-storage';

package/src/lib/folio.ts

@@ -1,23 +1,26 @@
 'use server';
 
 import { createServerClient } from './client-ssr';
-import { TohokuCatalogEntry } from './types';
+import { DataClient, TohokuCatalogEntry } from './types';
 import { FolioDTO, folioFromDTO } from './types/folio';
 
-export const getFolios = async ({
-  uuid,
-  toh,
-  page = 0,
-  size = 10,
-}: {
+type GetWorkFoliosArgs = {
+  client: DataClient;
   uuid: string;
   toh: TohokuCatalogEntry;
   page?: number;
   size?: number;
-}) => {
+};
+
+export const getWorkFolios = async ({
+  client,
+  uuid,
+  toh,
+  page = 0,
+  size = 10,
+}: GetWorkFoliosArgs) => {
   const start = page * size;
   const end = start + size - 1;
-  const client = await createServerClient();
   const { data, error } = await client
     .from('tibetan_works_folios')
     .select(
@@ -30,6 +33,7 @@ export const getFolios = async ({
     )
     .eq('work_uuid', uuid)
     .eq('toh', toh)
+    .order('volume_number', { ascending: true })
     .order('folio_number', { ascending: true })
     .order('side', { ascending: true })
     .range(start, end);
@@ -41,3 +45,13 @@ export const getFolios = async ({
 
   return data.map((dto) => folioFromDTO(dto as FolioDTO));
 };
+
+export const getFolios = async ({
+  uuid,
+  toh,
+  page = 0,
+  size = 10,
+}: Omit<GetWorkFoliosArgs, 'client'>) => {
+  const client = await createServerClient();
+  return getWorkFolios({ client, uuid, toh, page, size });
+};

package/src/lib/glossary/batch.ts

@@ -0,0 +1,35 @@
+import { DataClient } from '../types';
+
+export const getGlossaryDisplayNamesByUuids = async ({
+  client,
+  glossaryUuids,
+}: {
+  client: DataClient;
+  glossaryUuids: readonly string[];
+}): Promise<Map<string, string>> => {
+  const namesByUuid = new Map<string, string>();
+  if (glossaryUuids.length === 0) return namesByUuid;
+
+  const { data, error } = await client
+    .from('glossaries')
+    .select('uuid, names:names!name_uuid(content)')
+    .in('uuid', glossaryUuids as string[]);
+
+  if (error) {
+    console.error('Error batch loading glossary names:', error);
+    return namesByUuid;
+  }
+
+  for (const glossary of data ?? []) {
+    const names = glossary.names as unknown as
+      | { content: string }
+      | { content: string }[]
+      | null;
+    const content = Array.isArray(names) ? names[0]?.content : names?.content;
+    if (content) {
+      namesByUuid.set(glossary.uuid, content);
+    }
+  }
+
+  return namesByUuid;
+};

package/src/lib/glossary/index.ts

@@ -0,0 +1,4 @@
+export * from './batch';
+export * from './instance';
+export * from './landing';
+export * from './pagination';

package/src/lib/glossary/instance.ts

@@ -0,0 +1,54 @@
+import {
+  DataClient,
+  GlossaryTermInstanceDTO,
+  GlossaryTermInstancesDTO,
+  glossaryTermInstanceFromDTO,
+} from '../types';
+
+export const getGlossaryInstances = async ({
+  client,
+  uuid,
+  withAttestations = false,
+}: {
+  client: DataClient;
+  uuid: string;
+  withAttestations?: boolean;
+}) => {
+  const { data, error } = await client.rpc('show_glossary_entries', {
+    v_work_uuid: uuid,
+    v_with_attestation: withAttestations,
+  });
+  if (error) {
+    console.error(
+      `Error fetching glossary instances for work: ${uuid} `,
+      error,
+    );
+    return [];
+  }
+
+  const dto = data as GlossaryTermInstancesDTO;
+  return dto.glossary_entries.map(glossaryTermInstanceFromDTO).sort((a, b) => {
+    const nameA = a.names.english || '';
+    const nameB = b.names.english || '';
+    return nameA.localeCompare(nameB);
+  });
+};
+
+export const getGlossaryInstance = async ({
+  client,
+  uuid,
+}: {
+  client: DataClient;
+  uuid: string;
+}) => {
+  const { data, error } = await client.rpc('show_glossary_entry', {
+    v_glossary_uuid: uuid,
+  });
+
+  if (error) {
+    console.error(`Error fetching glossary instance: ${uuid} `, error);
+    return undefined;
+  }
+
+  return glossaryTermInstanceFromDTO(data as GlossaryTermInstanceDTO);
+};

package/src/lib/glossary/landing.ts

@@ -0,0 +1,50 @@
+import {
+  DataClient,
+  GlossaryLandingItem,
+  GlossaryLandingItemDTO,
+  glossaryLandingItemFromDTO,
+} from '../types';
+
+export const getAllGlossaryTerms = async ({
+  client,
+  uuids,
+}: {
+  client: DataClient;
+  uuids?: string[];
+}): Promise<GlossaryLandingItem[]> => {
+  const pageSize = 1000;
+  let start = 0;
+  let end = pageSize - 1;
+  let count = pageSize;
+  const terms: GlossaryLandingItem[] = [];
+
+  while (count === pageSize) {
+    let rpc = client.rpc('scholar_glossary_get_all');
+
+    if (uuids?.length) {
+      rpc = rpc.in('authority_uuid', uuids);
+    }
+
+    const { data, error } = await rpc.range(start, end);
+
+    if (error) {
+      console.error('Error fetching glossary terms:', error);
+      return [];
+    }
+    if (!data || !data.length) {
+      break;
+    }
+
+    const dtos = data as GlossaryLandingItemDTO[];
+    const items = dtos
+      .map((item) => glossaryLandingItemFromDTO(item as GlossaryLandingItemDTO))
+      .flatMap((item) => (item ? [item] : []));
+
+    terms.push(...items);
+    start += pageSize;
+    end += pageSize;
+    count = data.length;
+  }
+
+  return terms;
+};