arxiv-api-wrapper 1.0.0

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "arxiv-api-wrapper",
+  "version": "1.0.0",
+  "description": "Provides functions wrapping the arXiv API",
+  "keywords": [
+    "arxiv"
+  ],
+  "homepage": "https://github.com/vagdur/arxiv-api-wrapper#readme",
+  "bugs": {
+    "url": "https://github.com/vagdur/arxiv-api-wrapper/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vagdur/arxiv-api-wrapper.git"
+  },
+  "license": "ISC",
+  "author": "Vilhelm Agdur",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "scripts": {
+    "test": "vitest run --config tests/vitest.config.mts"
+  },
+  "dependencies": {
+    "fast-xml-parser": "^4.3.5"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  }
+}

package/src/arxivAPIRead.ts

@@ -0,0 +1,155 @@
+import { ArxivQueryOptions, ArxivQueryResult, ArxivSearchFilters } from './types';
+import { TokenBucketLimiter } from './rateLimiter';
+import { fetchWithRetry } from './http';
+import { parseEntries, parseFeedMeta } from './atom';
+
+const ARXIV_BASE_URL = 'https://export.arxiv.org/api/query';
+
+function encodeAuthor(term: string): string {
+  // Always quote terms to match arXiv's expected format
+  // Keep spaces - they'll be URL-encoded as %20
+  const normalized = term.trim();
+  return '"' + normalized + '"';
+}
+
+function encodePhrase(term: string, phraseExact?: boolean): string {
+  // Always quote terms to match arXiv's expected format
+  // Keep spaces - they'll be URL-encoded as %20
+  const normalized = term.trim();
+  return '"' + normalized + '"';
+}
+
+function fieldExpr(field: string, terms: string[] = [], phraseExact?: boolean): string[] {
+  if (!terms.length) return [];
+  if (field === 'au') {
+    return terms.map((t) => `${field}:${encodeAuthor(t)}`);
+  }
+  return terms.map((t) => `${field}:${encodePhrase(t, phraseExact)}`);
+}
+
+function rangeExpr(field: string, from: string, to: string): string {
+  return `${field}:[${from}+TO+${to}]`;
+}
+
+function groupOr(subfilters: string[]): string {
+  if (subfilters.length === 0) return '';
+  if (subfilters.length === 1) return subfilters[0];
+  return `(${subfilters.join('+OR+')})`;
+}
+
+function groupParen(expr: string): string {
+  return `(${expr})`;
+}
+
+function joinAnd(parts: string[]): string {
+  return parts.filter(Boolean).join('+AND+');
+}
+
+export function buildSearchQuery(filters: ArxivSearchFilters): string {
+  const parts: string[] = [];
+  const phraseExact = filters.phraseExact;
+
+  parts.push(...fieldExpr('all', filters.all, phraseExact)); // "all:" is supported per manual
+  parts.push(...fieldExpr('ti', filters.title, phraseExact));
+  parts.push(...fieldExpr('au', filters.author, phraseExact));
+  parts.push(...fieldExpr('abs', filters.abstract, phraseExact));
+  parts.push(...fieldExpr('co', filters.comment, phraseExact));
+  parts.push(...fieldExpr('jr', filters.journalRef, phraseExact));
+  parts.push(...fieldExpr('cat', filters.category, false));
+
+  if (filters.submittedDateRange) {
+    const { from, to } = filters.submittedDateRange;
+    parts.push(rangeExpr('submittedDate', from, to));
+  }
+
+  // OR group: each subfilter becomes an AND-joined clause, then ORed as a group
+  if (filters.or && filters.or.length > 0) {
+    const orClauses = filters.or.map((sf) => buildSearchQuery({ ...sf, or: undefined, andNot: undefined }));
+    const grouped = groupOr(orClauses);
+    if (grouped) parts.push(grouped);
+  }
+
+  // Build the base query from regular parts
+  const baseQuery = joinAnd(parts);
+
+  // ANDNOT group: a single negated clause (appended separately, not joined with AND)
+  if (filters.andNot) {
+    const neg = buildSearchQuery({ ...filters.andNot, or: undefined, andNot: undefined });
+    if (neg) {
+      if (baseQuery) {
+        return `${baseQuery}+ANDNOT+${groupParen(neg)}`;
+      }
+      return `ANDNOT+${groupParen(neg)}`;
+    }
+  }
+
+  return baseQuery;
+}
+
+function buildUrl(opts: ArxivQueryOptions): string {
+  const params: string[] = [];
+  
+  // Add id_list if it exists and has at least one item
+  if (opts.idList && Array.isArray(opts.idList) && opts.idList.length > 0) {
+    params.push('id_list=' + encodeURIComponent(opts.idList.join(',')));
+  }
+  
+  // Add search_query if search is provided (can be used together with id_list)
+  if (opts.search) {
+    const q = buildSearchQuery(opts.search);
+    // Encode the query properly: use encodeURIComponent to encode all special characters,
+    // then replace %2B back to + so that + signs decode as spaces (arXiv expects spaces around AND/OR)
+    const encodedQuery = encodeURIComponent(q).replace(/%2B/g, '+');
+    params.push('search_query=' + encodedQuery);
+  }
+  if (typeof opts.start === 'number') params.push('start=' + String(opts.start));
+  if (typeof opts.maxResults === 'number') params.push('max_results=' + String(opts.maxResults));
+  if (opts.sortBy) params.push('sortBy=' + encodeURIComponent(opts.sortBy));
+  if (opts.sortOrder) params.push('sortOrder=' + encodeURIComponent(opts.sortOrder));
+  const qs = params.join('&');
+  return `${ARXIV_BASE_URL}?${qs}`;
+}
+
+export async function getArxivEntries(options: ArxivQueryOptions): Promise<ArxivQueryResult> {
+  const timeoutMs = options.timeoutMs ?? 10000;
+  const retries = options.retries ?? 3;
+  const userAgent = options.userAgent ?? 'arxiv-api-wrapper/1.0 (+https://export.arxiv.org)';
+
+  const limiter = options.rateLimit
+    ? new TokenBucketLimiter(options.rateLimit.tokensPerInterval, options.rateLimit.intervalMs)
+    : undefined;
+
+  const url = buildUrl(options);
+  if (limiter) await limiter.acquire();
+
+  const res = await fetchWithRetry(url, { method: 'GET', headers: { Accept: 'application/atom+xml' } }, { retries, timeoutMs, userAgent });
+  
+  // Check response status before parsing
+  if (!res.ok) {
+    const errorText = await res.text().catch(() => 'Unable to read error response');
+    throw new Error(
+      `arXiv API returned status ${res.status} ${res.statusText} for URL: ${url}. ` +
+      `Response: ${errorText.substring(0, 500)}`
+    );
+  }
+  
+  const text = await res.text();
+  
+  // Log the response for debugging if it appears empty
+  if (!text || text.trim().length === 0) {
+    console.error(`Empty response from arXiv API. URL: ${url}, Status: ${res.status}`);
+    throw new Error(`arXiv API returned empty response for URL: ${url}`);
+  }
+
+  const feed = parseFeedMeta(text);
+  const entries = parseEntries(text);
+  
+  // Log if parsing resulted in empty data
+  if (feed.totalResults === 0 && entries.length === 0 && text.length > 0) {
+    console.warn(`Parsed empty results from non-empty response. URL: ${url}, Response length: ${text.length}`);
+    console.warn(`Response preview (first 500 chars): ${text.substring(0, 500)}`);
+  }
+  
+  return { feed, entries };
+}
+

package/src/atom.ts

@@ -0,0 +1,116 @@
+import { ArxivEntry, ArxivFeedMeta, ArxivLink } from './types';
+import { XMLParser } from 'fast-xml-parser';
+
+// XML parser configured to keep attributes and drop namespace prefixes
+const parser = new XMLParser({
+  ignoreAttributes: false,
+  attributeNamePrefix: '',
+  removeNSPrefix: true,
+  trimValues: true,
+  parseTagValue: true,
+});
+
+function extractArxivId(absUrl: string | undefined): string {
+  if (!absUrl) return '';
+  const cleaned = absUrl.split('#')[0].split('?')[0];
+  const idx = cleaned.lastIndexOf('/');
+  const last = idx >= 0 ? cleaned.slice(idx + 1) : cleaned;
+  return last.replace(/^arXiv:/i, '');
+}
+
+function normalizeWhitespace(str: string): string {
+  return str.replace(/\s+/g, ' ').trim();
+}
+
+export function parseFeedMeta(xml: string): ArxivFeedMeta {
+  const doc = parser.parse(xml) as any;
+  const feed = doc.feed || {};
+
+  const title: string = feed.title ?? '';
+  const id: string = feed.id ?? '';
+  const updated: string = feed.updated ?? '';
+
+  const linksArr: any[] = Array.isArray(feed.link) ? feed.link : (feed.link ? [feed.link] : []);
+  const selfLink = linksArr.find((l) => l.rel === 'self')?.href;
+  const feedLink: string = selfLink || linksArr[0]?.href || '';
+
+  const totalResultsRaw = feed.totalResults ?? feed['opensearch:totalResults'] ?? '0';
+  const startIndexRaw = feed.startIndex ?? feed['opensearch:startIndex'] ?? '0';
+  const itemsPerPageRaw = feed.itemsPerPage ?? feed['opensearch:itemsPerPage'] ?? '0';
+
+  const totalResults = parseInt(String(totalResultsRaw), 10) || 0;
+  const startIndex = parseInt(String(startIndexRaw), 10) || 0;
+  const itemsPerPage = parseInt(String(itemsPerPageRaw), 10) || 0;
+
+  return { id, updated, title, link: feedLink, totalResults, startIndex, itemsPerPage };
+}
+
+export function parseEntries(xml: string): ArxivEntry[] {
+  const doc = parser.parse(xml) as any;
+  const feed = doc.feed || {};
+  const rawEntries = Array.isArray(feed.entry) ? feed.entry : (feed.entry ? [feed.entry] : []);
+
+  const entries: ArxivEntry[] = rawEntries.map((e: any) => {
+    const idUrl: string = e.id || '';
+    const published: string = e.published || '';
+    const updated: string = e.updated || '';
+    const title: string = normalizeWhitespace(e.title || '');
+    const summary: string = normalizeWhitespace(e.summary || '');
+
+    const authorBlocks = Array.isArray(e.author) ? e.author : (e.author ? [e.author] : []);
+    const authors: { name: string; affiliation?: string }[] = authorBlocks.map((ab: any) => {
+      const affiliation = ab.affiliation || ab['arxiv:affiliation'];
+      return {
+        name: ab.name || '',
+        ...(affiliation ? { affiliation } : {}),
+      };
+    });
+
+    const categoriesArr = Array.isArray(e.category) ? e.category : (e.category ? [e.category] : []);
+    const categories = categoriesArr.map((c: any) => c.term).filter(Boolean) as string[];
+    const primaryCategoryObj = e.primary_category || e['arxiv:primary_category'];
+    const primaryCategory: string | undefined = primaryCategoryObj?.term;
+
+    const linksArr = Array.isArray(e.link) ? e.link : (e.link ? [e.link] : []);
+    const links: ArxivLink[] = linksArr
+      .map((l: any) => {
+        const link: ArxivLink = {
+          href: l.href,
+          ...(l.rel ? { rel: l.rel } : {}),
+          ...(l.type ? { type: l.type } : {}),
+          ...(l.title ? { title: l.title } : {}),
+        };
+        return link;
+      })
+      .filter((l: ArxivLink) => !!l.href);
+
+    const doi: string | undefined = e.doi || e['arxiv:doi'];
+    const journalRef: string | undefined = e.journal_ref || e['arxiv:journal_ref'];
+    const comment: string | undefined = normalizeWhitespace(e.comment || e['arxiv:comment'] || '');
+
+    const absHref =
+      links.find((l) => (l.rel === 'alternate' || !l.rel) && l.href?.includes('/abs/'))?.href
+      || links.find((l) => l.href?.includes('/abs/'))?.href;
+
+    const chosenId = idUrl || absHref || '';
+
+    return {
+      id: chosenId,
+      arxivId: extractArxivId(chosenId),
+      title,
+      summary,
+      published,
+      updated,
+      authors,
+      categories,
+      ...(primaryCategory ? { primaryCategory } : {}),
+      links,
+      ...(doi ? { doi } : {}),
+      ...(journalRef ? { journalRef } : {}),
+      ...(comment ? { comment } : {}),
+    } as ArxivEntry;
+  });
+
+  return entries;
+}
+

package/src/http.ts

@@ -0,0 +1,92 @@
+export interface RetryOptions {
+  retries: number;
+  timeoutMs: number;
+  userAgent?: string;
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+function computeBackoff(attempt: number): number {
+  const base = 200; // 200ms base
+  const max = 5000; // 5s cap
+  const exp = Math.min(max, base * 2 ** attempt);
+  const jitter = Math.random() * 0.2 * exp; // +/-20%
+  return Math.floor(exp * 0.9 + jitter);
+}
+
+export async function fetchWithRetry(
+  url: string,
+  init: RequestInit,
+  options: RetryOptions
+): Promise<Response> {
+  const { retries, timeoutMs, userAgent } = options;
+
+  let lastError: unknown;
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const headers = new Headers(init.headers || {});
+      if (userAgent) headers.set('User-Agent', userAgent);
+      const res = await fetch(url, { ...init, headers, signal: controller.signal });
+      clearTimeout(timeout);
+
+      if (res.ok) return res;
+
+      // 429 or 5xx -> retry
+      if (res.status === 429 || (res.status >= 500 && res.status <= 599)) {
+        if (attempt === retries) return res; // give up returning the last response
+        const retryAfter = res.headers.get('Retry-After');
+        let delay = computeBackoff(attempt);
+        if (retryAfter) {
+          const retryAfterSeconds = parseInt(retryAfter, 10);
+          if (!Number.isNaN(retryAfterSeconds)) {
+            delay = Math.max(delay, retryAfterSeconds * 1000);
+          }
+        }
+        await sleep(delay);
+        continue;
+      }
+
+      // Non-retriable HTTP status
+      return res;
+    } catch (err) {
+      clearTimeout(timeout);
+      lastError = err;
+      
+      // Enhance error message with context
+      const isAbortError = err instanceof Error && 
+        (err.name === 'AbortError' || err.message.includes('aborted'));
+      const isTimeout = isAbortError;
+      
+      if (attempt === retries) {
+        // On final attempt, throw enhanced error
+        if (isTimeout) {
+          throw new Error(
+            `Request to ${url} timed out after ${timeoutMs}ms ` +
+            `(attempt ${attempt + 1} of ${retries + 1}). ` +
+            `Original error: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+        throw err;
+      }
+      
+      // Log retry attempt for debugging
+      if (isTimeout) {
+        console.warn(
+          `Request to ${url} timed out (attempt ${attempt + 1} of ${retries + 1}), ` +
+          `retrying after backoff...`
+        );
+      }
+      
+      await sleep(computeBackoff(attempt));
+      continue;
+    }
+  }
+
+  // Should not reach here; throw last error if any
+  throw lastError instanceof Error ? lastError : new Error('Request failed');
+}
+

package/src/index.ts

@@ -0,0 +1,16 @@
+// Main entry point for the arXiv API wrapper package
+export { getArxivEntries, buildSearchQuery } from './arxivAPIRead';
+export type {
+  ArxivQueryOptions,
+  ArxivQueryResult,
+  ArxivSearchFilters,
+  ArxivEntry,
+  ArxivFeedMeta,
+  ArxivAuthor,
+  ArxivLink,
+  ArxivSortBy,
+  ArxivSortOrder,
+  ArxivRateLimitConfig,
+  ArxivDateRange,
+} from './types';
+

package/src/rateLimiter.ts

@@ -0,0 +1,54 @@
+export class TokenBucketLimiter {
+  private capacity: number;
+  private tokens: number;
+  private refillIntervalMs: number;
+  private lastRefill: number;
+  private queue: Array<() => void> = [];
+
+  constructor(tokensPerInterval: number, intervalMs: number) {
+    this.capacity = Math.max(1, tokensPerInterval);
+    this.tokens = this.capacity;
+    this.refillIntervalMs = Math.max(1, intervalMs);
+    this.lastRefill = Date.now();
+  }
+
+  private refill(): void {
+    const now = Date.now();
+    const elapsed = now - this.lastRefill;
+    if (elapsed <= 0) return;
+    const tokensToAdd = (elapsed / this.refillIntervalMs) * this.capacity;
+    if (tokensToAdd >= 1) {
+      this.tokens = Math.min(this.capacity, this.tokens + Math.floor(tokensToAdd));
+      this.lastRefill = now;
+    }
+  }
+
+  async acquire(): Promise<void> {
+    this.refill();
+    if (this.tokens > 0) {
+      this.tokens -= 1;
+      return;
+    }
+    return new Promise((resolve) => {
+      this.queue.push(resolve);
+      this.schedule();
+    });
+  }
+
+  private schedule(): void {
+    // Use a single timer tick to attempt to drain the queue
+    setTimeout(() => {
+      this.refill();
+      while (this.tokens > 0 && this.queue.length > 0) {
+        const next = this.queue.shift();
+        if (!next) break;
+        this.tokens -= 1;
+        next();
+      }
+      if (this.queue.length > 0) {
+        this.schedule();
+      }
+    }, Math.ceil(this.refillIntervalMs / this.capacity));
+  }
+}
+

package/src/types.ts

@@ -0,0 +1,87 @@
+export type ArxivSortBy = 'relevance' | 'lastUpdatedDate' | 'submittedDate';
+export type ArxivSortOrder = 'ascending' | 'descending';
+
+export interface ArxivRateLimitConfig {
+  tokensPerInterval: number;
+  intervalMs: number;
+}
+
+export interface ArxivDateRange {
+  from: string; // YYYYMMDDTTTT (GMT)
+  to: string;   // YYYYMMDDTTTT (GMT)
+}
+
+export interface ArxivSearchFilters {
+  all?: string[];
+  title?: string[]; // ti:
+  author?: string[]; // au:
+  abstract?: string[]; // abs:
+  comment?: string[]; // co:
+  journalRef?: string[]; // jr:
+  category?: string[]; // cat:
+  submittedDateRange?: ArxivDateRange; // submittedDate:[from TO to]
+
+  // Composition
+  or?: ArxivSearchFilters[]; // grouped OR of subfilters
+  andNot?: ArxivSearchFilters; // negated subfilter
+
+  // Encoding behavior
+  phraseExact?: boolean; // wrap each term in quotes
+}
+
+export interface ArxivQueryOptions {
+  idList?: string[];
+  search?: ArxivSearchFilters; // ignored if idList present
+  start?: number; // 0-based
+  maxResults?: number; // <= 300 per arXiv guidance
+  sortBy?: ArxivSortBy;
+  sortOrder?: ArxivSortOrder;
+  timeoutMs?: number; // default 10000
+  retries?: number; // default 3
+  rateLimit?: ArxivRateLimitConfig;
+  userAgent?: string; // optional custom UA header
+}
+
+export interface ArxivLink {
+  href: string;
+  rel?: string;
+  type?: string;
+  title?: string;
+}
+
+export interface ArxivAuthor {
+  name: string;
+  affiliation?: string;
+}
+
+export interface ArxivEntry {
+  id: string; // abs URL
+  arxivId: string; // e.g., 2101.01234v2
+  title: string;
+  summary: string;
+  published: string;
+  updated: string;
+  authors: ArxivAuthor[];
+  categories: string[];
+  primaryCategory?: string;
+  links: ArxivLink[];
+  doi?: string;
+  journalRef?: string;
+  comment?: string;
+}
+
+export interface ArxivFeedMeta {
+  id: string;
+  updated: string;
+  title: string;
+  link: string;
+  totalResults: number;
+  startIndex: number;
+  itemsPerPage: number;
+}
+
+export interface ArxivQueryResult {
+  feed: ArxivFeedMeta;
+  entries: ArxivEntry[];
+}
+

package/tests/arxivAPI.integration.test.ts

@@ -0,0 +1,98 @@
+import { describe, it, test, expect } from 'vitest';
+import { getArxivEntries } from '../src/arxivAPIRead';
+
+// Integration tests that make real HTTP calls to arXiv API.
+// These are intentionally conservative in request size and rate.
+
+describe('arXiv API integration', () => {
+  test('fetches results by search_query and then by id_list', async () => {
+    console.log('Starting first API call (search query)...');
+    let first;
+    try {
+      first = await getArxivEntries({
+        search: {
+          title: ['overlapping'],
+          author: ['Vilhelm Agdur'],
+        },
+        start: 0,
+        maxResults: 1,
+        sortBy: 'submittedDate',
+        sortOrder: 'descending',
+        timeoutMs: 15000,
+        retries: 2,
+        rateLimit: { tokensPerInterval: 1, intervalMs: 1000 },
+        userAgent: 'arxiv-api-wrapper-tests/1.0',
+      });
+      console.log('First API call completed successfully');
+    } catch (error) {
+      console.error('First API call failed:', error);
+      throw new Error(`Failed to fetch search results: ${error instanceof Error ? error.message : String(error)}`);
+    }
+
+    expect(first.feed).toBeTruthy();
+    expect(typeof first.feed.totalResults).toBe('number');
+    expect(Array.isArray(first.entries)).toBe(true);
+    expect(first.entries.length).toBeGreaterThanOrEqual(0);
+
+    if (first.entries.length === 0) {
+      const responseDetails = {
+        feed: first.feed,
+        totalResults: first.feed?.totalResults,
+        entriesCount: first.entries.length,
+        entries: first.entries,
+      };
+      console.error('No entries returned from search query. Response details:', JSON.stringify(responseDetails, null, 2));
+      throw new Error(
+        `Search query (title: "overlapping", author: "Vilhelm Agdur") returned no entries. ` +
+        `Feed metadata: totalResults=${first.feed?.totalResults}, ` +
+        `entries array length=${first.entries.length}. ` +
+        `This indicates the API call succeeded but returned no results, which is unexpected.`
+      );
+    }
+
+    // Verify the first result matches the search criteria
+    const firstEntry = first.entries[0];
+    
+    // Check that the title contains "overlapping" (case-insensitive)
+    const titleLower = firstEntry.title.toLowerCase();
+    expect(titleLower).toContain('overlapping');
+    
+    // Check that at least one author is "Vilhelm Agdur"
+    const authorNames = firstEntry.authors.map(a => a.name);
+    const hasVilhelmAgdur = authorNames.some(name => 
+      name.toLowerCase().includes('vilhelm') && name.toLowerCase().includes('agdur')
+    );
+    expect(hasVilhelmAgdur).toBe(true);
+    
+    // Log the actual result for debugging if needed
+    console.log(`Verified result: title="${firstEntry.title}", authors=[${authorNames.join(', ')}]`);
+
+    const arxivId = firstEntry.arxivId;
+    if (!arxivId) {
+      console.log('No arxivId found in first entry, skipping id_list test');
+      return; // Skip id_list fetch if id is unavailable
+    }
+
+    console.log(`Starting second API call (id_list) for arxivId: ${arxivId}`);
+    let second;
+    try {
+      second = await getArxivEntries({
+        idList: [arxivId],
+        timeoutMs: 15000,
+        retries: 2,
+        rateLimit: { tokensPerInterval: 1, intervalMs: 1000 },
+        userAgent: 'arxiv-api-wrapper-tests/1.0',
+      });
+      console.log('Second API call completed successfully');
+    } catch (error) {
+      console.error('Second API call failed:', error);
+      throw new Error(`Failed to fetch entry by id_list: ${error instanceof Error ? error.message : String(error)}`);
+    }
+
+    expect(second.entries.length).toBeGreaterThanOrEqual(1);
+    expect(second.entries[0].arxivId).toBe(arxivId);
+    expect(second.entries[0].title.length).toBeGreaterThan(0);
+    expect(second.entries[0].links.length).toBeGreaterThanOrEqual(1);
+  }, 120000); // Increased to 120 seconds to account for rate limiting, retries, and backoff delays
+});
+

package/tests/arxivAPIRead.test.ts

@@ -0,0 +1,36 @@
+// Basic tests for query building logic using Vitest
+import { describe, it, expect } from 'vitest';
+import { buildSearchQuery } from '../src/arxivAPIRead';
+
+describe('buildSearchQuery', () => {
+  it('ANDs top-level fields', () => {
+    const q = buildSearchQuery({ author: ['Ada Lovelace'], title: ['analysis'] });
+    expect(q).toMatch(/au:\"Ada Lovelace\"/);
+    expect(q).toMatch(/ti:\"analysis\"/);
+    expect(q).toMatch(/\+AND\+/);
+  });
+
+  it('handles OR subfilters', () => {
+    const q = buildSearchQuery({
+      author: ['Adrian DelMaestro'],
+      or: [{ title: ['checkerboard'] }, { title: ['Pyrochlore'] }],
+    });
+    expect(q).toMatch(/^au:\"Adrian DelMaestro\"\+AND\+\(ti:\"checkerboard\"\+OR\+ti:\"Pyrochlore\"\)$/);
+  });
+
+  it('handles ANDNOT', () => {
+    const q = buildSearchQuery({ author: ['Adrian DelMaestro'], andNot: { title: ['checkerboard'] } });
+      expect(q).toBe('au:\"Adrian DelMaestro\"+ANDNOT+(ti:\"checkerboard\")');
+    });
+
+    it('encodes phrases when phraseExact', () => {
+      const q = buildSearchQuery({ title: ['quantum criticality'], phraseExact: true });
+    expect(q).toBe('ti:"quantum criticality"');
+  });
+
+  it('handles submittedDate range', () => {
+    const q = buildSearchQuery({ submittedDateRange: { from: '202301010600', to: '202401010600' } });
+    expect(q).toBe('submittedDate:[202301010600+TO+202401010600]');
+  });
+});
+

package/tests/atomParser.test.ts

@@ -0,0 +1,19 @@
+import { describe, it, expect } from 'vitest';
+import { parseEntries } from '../src/atom.js';
+import { xmlString as xml2507_17541 } from './fixtures/parseEntries/2507.17541.xml.js';
+import { expectedEntries as expected2507_17541 } from './fixtures/parseEntries/2507.17541.json.js';
+import { xmlString as xmlSearchAgdur } from './fixtures/parseEntries/search_agdur.xml.js';
+import { expectedEntries as expectedSearchAgdur } from './fixtures/parseEntries/search_agdur.json.js';
+
+describe('parseEntries', () => {
+  it('should correctly parse 2507.17541', () => {
+    const result = parseEntries(xml2507_17541);
+    expect(result).toEqual(expected2507_17541);
+  });
+
+  it('should correctly parse search_agdur', () => {
+    const result = parseEntries(xmlSearchAgdur);
+    expect(result).toEqual(expectedSearchAgdur);
+  });
+});
+

package/tests/fixtures/parseEntries/2507.17541.json.ts

@@ -0,0 +1,51 @@
+import { ArxivEntry } from '../../../src/types';
+
+export const expectedEntries: ArxivEntry[] = [
+  {
+    id: "http://arxiv.org/abs/2507.17541v1",
+    arxivId: "2507.17541v1",
+    title: "Approximating temporal modularity on graphs of small underlying treewidth",
+    summary: "Modularity is a very widely used measure of the level of clustering or community structure in networks. Here we consider a recent generalisation of the definition of modularity to temporal graphs, whose edge-sets change over discrete timesteps; such graphs offer a more realistic model of many real-world networks in which connections between entities (for example, between individuals in a social network) evolve over time. Computing modularity is notoriously difficult: it is NP-hard even to approximate in general, and only admits efficient exact algorithms in very restricted special cases. Our main result is that a multiplicative approximation to temporal modularity can be computed efficiently when the underlying graph has small treewidth. This generalises a similar approximation algorithm for the static case, but requires some substantially new ideas to overcome technical challenges associated with the temporal nature of the problem.",
+    published: "2025-07-23T14:19:44Z",
+    updated: "2025-07-23T14:19:44Z",
+    authors: [
+      {
+        name: "Vilhelm Agdur"
+      },
+      {
+        name: "Jessica Enright"
+      },
+      {
+        name: "Laura Larios-Jones"
+      },
+      {
+        name: "Kitty Meeks"
+      },
+      {
+        name: "Fiona Skerman"
+      },
+      {
+        name: "Ella Yates"
+      }
+    ],
+    categories: [
+      "math.CO",
+      "cs.DM"
+    ],
+    primaryCategory: "math.CO",
+    links: [
+      {
+        href: "http://arxiv.org/abs/2507.17541v1",
+        rel: "alternate",
+        type: "text/html"
+      },
+      {
+        href: "http://arxiv.org/pdf/2507.17541v1",
+        rel: "related",
+        type: "application/pdf",
+        title: "pdf"
+      }
+    ]
+  }
+];
+

package/tests/fixtures/parseEntries/2507.17541.xml.ts

@@ -0,0 +1,55 @@
+export const xmlString = `<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+  <link href="http://arxiv.org/api/query?search_query%3D%26id_list%3D2507.17541%26start%3D0%26max_results%3D10" rel="self" type="application/atom+xml"/>
+  <title type="html">ArXiv Query: search_query=&amp;id_list=2507.17541&amp;start=0&amp;max_results=10</title>
+  <id>http://arxiv.org/api/2nHSIZpGumk2UR1U9O6mUiVRGDM</id>
+  <updated>2025-10-29T00:00:00-04:00</updated>
+  <opensearch:totalResults xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">1</opensearch:totalResults>
+  <opensearch:startIndex xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">0</opensearch:startIndex>
+  <opensearch:itemsPerPage xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">10</opensearch:itemsPerPage>
+  <entry>
+    <id>http://arxiv.org/abs/2507.17541v1</id>
+    <updated>2025-07-23T14:19:44Z</updated>
+    <published>2025-07-23T14:19:44Z</published>
+    <title>Approximating temporal modularity on graphs of small underlying
+  treewidth</title>
+    <summary>  Modularity is a very widely used measure of the level of clustering or
+community structure in networks. Here we consider a recent generalisation of
+the definition of modularity to temporal graphs, whose edge-sets change over
+discrete timesteps; such graphs offer a more realistic model of many real-world
+networks in which connections between entities (for example, between
+individuals in a social network) evolve over time. Computing modularity is
+notoriously difficult: it is NP-hard even to approximate in general, and only
+admits efficient exact algorithms in very restricted special cases. Our main
+result is that a multiplicative approximation to temporal modularity can be
+computed efficiently when the underlying graph has small treewidth. This
+generalises a similar approximation algorithm for the static case, but requires
+some substantially new ideas to overcome technical challenges associated with
+the temporal nature of the problem.
+</summary>
+    <author>
+      <name>Vilhelm Agdur</name>
+    </author>
+    <author>
+      <name>Jessica Enright</name>
+    </author>
+    <author>
+      <name>Laura Larios-Jones</name>
+    </author>
+    <author>
+      <name>Kitty Meeks</name>
+    </author>
+    <author>
+      <name>Fiona Skerman</name>
+    </author>
+    <author>
+      <name>Ella Yates</name>
+    </author>
+    <link href="http://arxiv.org/abs/2507.17541v1" rel="alternate" type="text/html"/>
+    <link title="pdf" href="http://arxiv.org/pdf/2507.17541v1" rel="related" type="application/pdf"/>
+    <arxiv:primary_category xmlns:arxiv="http://arxiv.org/schemas/atom" term="math.CO" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="math.CO" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="cs.DM" scheme="http://arxiv.org/schemas/atom"/>
+  </entry>
+</feed>`;
+

package/tests/fixtures/parseEntries/search_agdur.json.ts

@@ -0,0 +1,155 @@
+import { ArxivEntry } from '../../../src/types';
+
+export const expectedEntries: ArxivEntry[] = [
+  {
+    id: "http://arxiv.org/abs/1906.03709v1",
+    arxivId: "1906.03709v1",
+    title: "Finitary Boolean functions",
+    summary: "We study functions on the infinite-dimensional Hamming cube $\\{-1,1\\}^\\infty$, in particular Boolean functions into $\\{-1,1\\}$, generalising results on analysis of Boolean functions on $\\{-1,1\\}^n$ for $n\\in\\mathbb{N}$. The notion of noise sensitivity, first studied in arXiv:math/9811157 , is extended to this setting, and basic Fourier formulas are established. We also prove hypercontractivity estimates for these functions, and give a version of the Kahn-Kalai-Linial theorem giving a bound relating the total influence to the maximal influence. Particular attention is paid to so-called finitary functions, which are functions for which there exists an algorithm that almost surely queries only finitely many bits. Two versions of the Benjamini-Kalai-Schramm theorem characterizing noise sensitivity in terms of the sum of squared influences are given, under additional moment hypotheses on the amount of bits looked at by an algorithm. A version of the Kahn-Kalai-Linial theorem giving that the maximal influence is of order $\\frac{\\log(n)}{n}$ is also given, replacing $n$ with the expected number of bits looked at by an algorithm. Finally, we show that the result in arXiv:math/0504586 that revealments going to zero implies noise sensitivity also holds for finitary functions, and apply this to show noise sensitivity of a version of the voter model on sufficiently sparse graphs.",
+    published: "2019-06-09T21:10:09Z",
+    updated: "2019-06-09T21:10:09Z",
+    authors: [
+      {
+        name: "Vilhelm Agdur"
+      }
+    ],
+    categories: [
+      "math.PR"
+    ],
+    primaryCategory: "math.PR",
+    links: [
+      {
+        href: "http://arxiv.org/abs/1906.03709v1",
+        rel: "alternate",
+        type: "text/html"
+      },
+      {
+        href: "http://arxiv.org/pdf/1906.03709v1",
+        rel: "related",
+        type: "application/pdf",
+        title: "pdf"
+      }
+    ],
+    comment: "33 pages, 2 figures. Originally as Master's Thesis at Gothenburg University"
+  },
+  {
+    id: "http://arxiv.org/abs/2404.03332v2",
+    arxivId: "2404.03332v2",
+    title: "A classification of overlapping clustering schemes for hypergraphs",
+    summary: "Community detection in graphs is a problem that is likely to be relevant whenever network data appears, and consequently the problem has received much attention with many different methods and algorithms applied. However, many of these methods are hard to study theoretically, and they optimise for somewhat different goals. A general and rigorous account of the problem and possible methods remains elusive. We study the problem of finding overlapping clusterings of hypergraphs, continuing the line of research started by Carlsson and M\\'emoli (2013) of classifying clustering schemes as functors. We extend their notion of representability to the overlapping case, showing that any representable overlapping clustering scheme is excisive and functorial, and any excisive and functorial clustering scheme is isomorphic to a representable clustering scheme. We also note that, for simple graphs, any representable clustering scheme is computable in polynomial time on graphs of bounded expansion, with an exponent determined by the maximum independence number of a graph in the representing set. This result also applies to non-overlapping representable clustering schemes, and so may be of independent interest.",
+    published: "2024-04-04T10:00:35Z",
+    updated: "2025-05-15T15:07:53Z",
+    authors: [
+      {
+        name: "Vilhelm Agdur"
+      }
+    ],
+    categories: [
+      "math.CO",
+      "cs.SI",
+      "math.CT"
+    ],
+    primaryCategory: "math.CO",
+    links: [
+      {
+        href: "http://arxiv.org/abs/2404.03332v2",
+        rel: "alternate",
+        type: "text/html"
+      },
+      {
+        href: "http://arxiv.org/pdf/2404.03332v2",
+        rel: "related",
+        type: "application/pdf",
+        title: "pdf"
+      }
+    ],
+    comment: "31 pages, 11 figures"
+  },
+  {
+    id: "http://arxiv.org/abs/2307.07271v1",
+    arxivId: "2307.07271v1",
+    title: "Universal lower bound for community structure of sparse graphs",
+    summary: "We prove new lower bounds on the modularity of graphs. Specifically, the modularity of a graph $G$ with average degree $\\bar d$ is $\\Omega(\\bar{d}^{-1/2})$, under some mild assumptions on the degree sequence of $G$. The lower bound $\\Omega(\\bar{d}^{-1/2})$ applies, for instance, to graphs with a power-law degree sequence or a near-regular degree sequence. It has been suggested that the relatively high modularity of the Erd\\H{o}s-R\\'enyi random graph $G_{n,p}$ stems from the random fluctuations in its edge distribution, however our results imply high modularity for any graph with a degree sequence matching that typically found in $G_{n,p}$. The proof of the new lower bound relies on certain weight-balanced bisections with few cross-edges, which build on ideas of Alon [Combinatorics, Probability and Computing (1997)] and may be of independent interest.",
+    published: "2023-07-14T10:53:12Z",
+    updated: "2023-07-14T10:53:12Z",
+    authors: [
+      {
+        name: "Vilhelm Agdur"
+      },
+      {
+        name: "Nina Kamčev"
+      },
+      {
+        name: "Fiona Skerman"
+      }
+    ],
+    categories: [
+      "math.CO",
+      "cs.DS",
+      "cs.SI",
+      "math.PR"
+    ],
+    primaryCategory: "math.CO",
+    links: [
+      {
+        href: "http://arxiv.org/abs/2307.07271v1",
+        rel: "alternate",
+        type: "text/html"
+      },
+      {
+        href: "http://arxiv.org/pdf/2307.07271v1",
+        rel: "related",
+        type: "application/pdf",
+        title: "pdf"
+      }
+    ],
+    comment: "25 pages, 2 figures"
+  },
+  {
+    id: "http://arxiv.org/abs/2507.17541v1",
+    arxivId: "2507.17541v1",
+    title: "Approximating temporal modularity on graphs of small underlying treewidth",
+    summary: "Modularity is a very widely used measure of the level of clustering or community structure in networks. Here we consider a recent generalisation of the definition of modularity to temporal graphs, whose edge-sets change over discrete timesteps; such graphs offer a more realistic model of many real-world networks in which connections between entities (for example, between individuals in a social network) evolve over time. Computing modularity is notoriously difficult: it is NP-hard even to approximate in general, and only admits efficient exact algorithms in very restricted special cases. Our main result is that a multiplicative approximation to temporal modularity can be computed efficiently when the underlying graph has small treewidth. This generalises a similar approximation algorithm for the static case, but requires some substantially new ideas to overcome technical challenges associated with the temporal nature of the problem.",
+    published: "2025-07-23T14:19:44Z",
+    updated: "2025-07-23T14:19:44Z",
+    authors: [
+      {
+        name: "Vilhelm Agdur"
+      },
+      {
+        name: "Jessica Enright"
+      },
+      {
+        name: "Laura Larios-Jones"
+      },
+      {
+        name: "Kitty Meeks"
+      },
+      {
+        name: "Fiona Skerman"
+      },
+      {
+        name: "Ella Yates"
+      }
+    ],
+    categories: [
+      "math.CO",
+      "cs.DM"
+    ],
+    primaryCategory: "math.CO",
+    links: [
+      {
+        href: "http://arxiv.org/abs/2507.17541v1",
+        rel: "alternate",
+        type: "text/html"
+      },
+      {
+        href: "http://arxiv.org/pdf/2507.17541v1",
+        rel: "related",
+        type: "application/pdf",
+        title: "pdf"
+      }
+    ]
+  }
+];
+

package/tests/fixtures/parseEntries/search_agdur.xml.ts

@@ -0,0 +1,162 @@
+export const xmlString = `<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+  <link href="http://arxiv.org/api/query?search_query%3Dau%3Aagdur%26id_list%3D%26start%3D0%26max_results%3D10" rel="self" type="application/atom+xml"/>
+  <title type="html">ArXiv Query: search_query=au:agdur&amp;id_list=&amp;start=0&amp;max_results=10</title>
+  <id>http://arxiv.org/api/K6Ns1KQAP9JrGj22od9phcPZdXE</id>
+  <updated>2025-10-31T00:00:00-04:00</updated>
+  <opensearch:totalResults xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">4</opensearch:totalResults>
+  <opensearch:startIndex xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">0</opensearch:startIndex>
+  <opensearch:itemsPerPage xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">10</opensearch:itemsPerPage>
+  <entry>
+    <id>http://arxiv.org/abs/1906.03709v1</id>
+    <updated>2019-06-09T21:10:09Z</updated>
+    <published>2019-06-09T21:10:09Z</published>
+    <title>Finitary Boolean functions</title>
+    <summary>  We study functions on the infinite-dimensional Hamming cube
+$\\{-1,1\\}^\\infty$, in particular Boolean functions into $\\{-1,1\\}$,
+generalising results on analysis of Boolean functions on $\\{-1,1\\}^n$ for
+$n\\in\\mathbb{N}$. The notion of noise sensitivity, first studied in
+arXiv:math/9811157 , is extended to this setting, and basic Fourier formulas
+are established. We also prove hypercontractivity estimates for these
+functions, and give a version of the Kahn-Kalai-Linial theorem giving a bound
+relating the total influence to the maximal influence.
+  Particular attention is paid to so-called finitary functions, which are
+functions for which there exists an algorithm that almost surely queries only
+finitely many bits. Two versions of the Benjamini-Kalai-Schramm theorem
+characterizing noise sensitivity in terms of the sum of squared influences are
+given, under additional moment hypotheses on the amount of bits looked at by an
+algorithm. A version of the Kahn-Kalai-Linial theorem giving that the maximal
+influence is of order $\\frac{\\log(n)}{n}$ is also given, replacing $n$ with the
+expected number of bits looked at by an algorithm.
+  Finally, we show that the result in arXiv:math/0504586 that revealments going
+to zero implies noise sensitivity also holds for finitary functions, and apply
+this to show noise sensitivity of a version of the voter model on sufficiently
+sparse graphs.
+</summary>
+    <author>
+      <name>Vilhelm Agdur</name>
+    </author>
+    <arxiv:comment xmlns:arxiv="http://arxiv.org/schemas/atom">33 pages, 2 figures. Originally as Master's Thesis at Gothenburg
+  University</arxiv:comment>
+    <link href="http://arxiv.org/abs/1906.03709v1" rel="alternate" type="text/html"/>
+    <link title="pdf" href="http://arxiv.org/pdf/1906.03709v1" rel="related" type="application/pdf"/>
+    <arxiv:primary_category xmlns:arxiv="http://arxiv.org/schemas/atom" term="math.PR" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="math.PR" scheme="http://arxiv.org/schemas/atom"/>
+  </entry>
+  <entry>
+    <id>http://arxiv.org/abs/2404.03332v2</id>
+    <updated>2025-05-15T15:07:53Z</updated>
+    <published>2024-04-04T10:00:35Z</published>
+    <title>A classification of overlapping clustering schemes for hypergraphs</title>
+    <summary>  Community detection in graphs is a problem that is likely to be relevant
+whenever network data appears, and consequently the problem has received much
+attention with many different methods and algorithms applied. However, many of
+these methods are hard to study theoretically, and they optimise for somewhat
+different goals. A general and rigorous account of the problem and possible
+methods remains elusive.
+  We study the problem of finding overlapping clusterings of hypergraphs,
+continuing the line of research started by Carlsson and M\\'emoli (2013) of
+classifying clustering schemes as functors. We extend their notion of
+representability to the overlapping case, showing that any representable
+overlapping clustering scheme is excisive and functorial, and any excisive and
+functorial clustering scheme is isomorphic to a representable clustering
+scheme.
+  We also note that, for simple graphs, any representable clustering scheme is
+computable in polynomial time on graphs of bounded expansion, with an exponent
+determined by the maximum independence number of a graph in the representing
+set. This result also applies to non-overlapping representable clustering
+schemes, and so may be of independent interest.
+</summary>
+    <author>
+      <name>Vilhelm Agdur</name>
+    </author>
+    <arxiv:comment xmlns:arxiv="http://arxiv.org/schemas/atom">31 pages, 11 figures</arxiv:comment>
+    <link href="http://arxiv.org/abs/2404.03332v2" rel="alternate" type="text/html"/>
+    <link title="pdf" href="http://arxiv.org/pdf/2404.03332v2" rel="related" type="application/pdf"/>
+    <arxiv:primary_category xmlns:arxiv="http://arxiv.org/schemas/atom" term="math.CO" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="math.CO" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="cs.SI" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="math.CT" scheme="http://arxiv.org/schemas/atom"/>
+  </entry>
+  <entry>
+    <id>http://arxiv.org/abs/2307.07271v1</id>
+    <updated>2023-07-14T10:53:12Z</updated>
+    <published>2023-07-14T10:53:12Z</published>
+    <title>Universal lower bound for community structure of sparse graphs</title>
+    <summary>  We prove new lower bounds on the modularity of graphs. Specifically, the
+modularity of a graph $G$ with average degree $\\bar d$ is
+$\\Omega(\\bar{d}^{-1/2})$, under some mild assumptions on the degree sequence of
+$G$. The lower bound $\\Omega(\\bar{d}^{-1/2})$ applies, for instance, to graphs
+with a power-law degree sequence or a near-regular degree sequence.
+  It has been suggested that the relatively high modularity of the
+Erd\\H{o}s-R\\'enyi random graph $G_{n,p}$ stems from the random fluctuations in
+its edge distribution, however our results imply high modularity for any graph
+with a degree sequence matching that typically found in $G_{n,p}$.
+  The proof of the new lower bound relies on certain weight-balanced bisections
+with few cross-edges, which build on ideas of Alon [Combinatorics, Probability
+and Computing (1997)] and may be of independent interest.
+</summary>
+    <author>
+      <name>Vilhelm Agdur</name>
+    </author>
+    <author>
+      <name>Nina Kamčev</name>
+    </author>
+    <author>
+      <name>Fiona Skerman</name>
+    </author>
+    <arxiv:comment xmlns:arxiv="http://arxiv.org/schemas/atom">25 pages, 2 figures</arxiv:comment>
+    <link href="http://arxiv.org/abs/2307.07271v1" rel="alternate" type="text/html"/>
+    <link title="pdf" href="http://arxiv.org/pdf/2307.07271v1" rel="related" type="application/pdf"/>
+    <arxiv:primary_category xmlns:arxiv="http://arxiv.org/schemas/atom" term="math.CO" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="math.CO" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="cs.DS" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="cs.SI" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="math.PR" scheme="http://arxiv.org/schemas/atom"/>
+  </entry>
+  <entry>
+    <id>http://arxiv.org/abs/2507.17541v1</id>
+    <updated>2025-07-23T14:19:44Z</updated>
+    <published>2025-07-23T14:19:44Z</published>
+    <title>Approximating temporal modularity on graphs of small underlying
+  treewidth</title>
+    <summary>  Modularity is a very widely used measure of the level of clustering or
+community structure in networks. Here we consider a recent generalisation of
+the definition of modularity to temporal graphs, whose edge-sets change over
+discrete timesteps; such graphs offer a more realistic model of many real-world
+networks in which connections between entities (for example, between
+individuals in a social network) evolve over time. Computing modularity is
+notoriously difficult: it is NP-hard even to approximate in general, and only
+admits efficient exact algorithms in very restricted special cases. Our main
+result is that a multiplicative approximation to temporal modularity can be
+computed efficiently when the underlying graph has small treewidth. This
+generalises a similar approximation algorithm for the static case, but requires
+some substantially new ideas to overcome technical challenges associated with
+the temporal nature of the problem.
+</summary>
+    <author>
+      <name>Vilhelm Agdur</name>
+    </author>
+    <author>
+      <name>Jessica Enright</name>
+    </author>
+    <author>
+      <name>Laura Larios-Jones</name>
+    </author>
+    <author>
+      <name>Kitty Meeks</name>
+    </author>
+    <author>
+      <name>Fiona Skerman</name>
+    </author>
+    <author>
+      <name>Ella Yates</name>
+    </author>
+    <link href="http://arxiv.org/abs/2507.17541v1" rel="alternate" type="text/html"/>
+    <link title="pdf" href="http://arxiv.org/pdf/2507.17541v1" rel="related" type="application/pdf"/>
+    <arxiv:primary_category xmlns:arxiv="http://arxiv.org/schemas/atom" term="math.CO" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="math.CO" scheme="http://arxiv.org/schemas/atom"/>
+    <category term="cs.DM" scheme="http://arxiv.org/schemas/atom"/>
+  </entry>
+</feed>`;
+

package/tests/vitest.config.mts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+  },
+});
+