@ncukondo/reference-manager 0.1.0 → 0.3.0

package/dist/features/import/detector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Format detection module for multi-format import
+ *
+ * Detects input format based on:
+ * - File extension (.json, .bib, .ris)
+ * - Content patterns (JSON, BibTeX, RIS)
+ * - Identifier patterns (PMID, DOI)
+ * - Multiple whitespace-separated identifiers
+ */
+/**
+ * Supported input formats
+ */
+export type InputFormat = "json" | "bibtex" | "ris" | "pmid" | "doi" | "identifiers" | "unknown";
+/**
+ * Detect the format of the given input
+ *
+ * @param input - File path, identifier, or empty string for stdin
+ * @param content - Optional content to analyze (for stdin or unknown extension)
+ * @returns Detected format
+ */
+export declare function detectFormat(input: string, content?: string): InputFormat;
+/**
+ * Detect format based on file extension
+ */
+export declare function detectByExtension(input: string): InputFormat;
+/**
+ * Detect format based on content patterns
+ */
+export declare function detectByContent(content: string): InputFormat;
+/**
+ * Detect if a single string is a PMID or DOI
+ */
+export declare function detectSingleIdentifier(input: string): "pmid" | "doi" | "unknown";
+/**
+ * Check if string is a valid DOI
+ */
+export declare function isDoi(input: string): boolean;
+/**
+ * Check if string is a valid PMID (numeric only)
+ */
+export declare function isPmid(input: string): boolean;
+//# sourceMappingURL=detector.d.ts.map

package/dist/features/import/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/features/import/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,SAAS,CAAC;AAqBjG;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAwBzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAW5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAqB5D;AAkCD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAYhF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAW5C;AA0BD;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO7C"}

package/dist/features/import/fetcher.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Fetcher module for PMID and DOI metadata retrieval
+ *
+ * - PMID: Uses PMC Citation Exporter API (returns CSL-JSON directly)
+ * - DOI: Uses citation-js plugin-doi (Cite.async)
+ */
+import "@citation-js/plugin-doi";
+import { type CslItem } from "../../core/csl-json/types.js";
+/**
+ * PubMed configuration for API requests
+ */
+export interface PubmedConfig {
+    email?: string;
+    apiKey?: string;
+}
+/**
+ * Result of fetching a single identifier
+ */
+export type FetchResult = {
+    success: true;
+    item: CslItem;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Result of fetching a PMID (includes pmid for tracking)
+ */
+export type PmidFetchResult = {
+    pmid: string;
+    success: true;
+    item: CslItem;
+} | {
+    pmid: string;
+    success: false;
+    error: string;
+};
+/**
+ * Results of fetching multiple PMIDs
+ */
+export type FetchResults = PmidFetchResult[];
+export declare function fetchPmids(pmids: string[], config: PubmedConfig): Promise<FetchResults>;
+/**
+ * Fetch metadata for a DOI using citation-js
+ *
+ * Uses @citation-js/plugin-doi for content negotiation
+ */
+export declare function fetchDoi(doi: string): Promise<FetchResult>;
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/features/import/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../src/features/import/fetcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,8BAA8B,CAAC;AAY3E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;AAiG7C,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA+C7F;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA0ChE"}

package/dist/features/import/importer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Importer orchestration module
+ *
+ * Coordinates format detection, parsing, and fetching to import references
+ * from various input formats.
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { InputFormat } from "./detector.js";
+import type { PubmedConfig } from "./fetcher.js";
+/**
+ * Result of importing a single item
+ */
+export type ImportItemResult = {
+    success: true;
+    item: CslItem;
+    source: string;
+} | {
+    success: false;
+    error: string;
+    source: string;
+};
+/**
+ * Result of an import operation
+ */
+export interface ImportResult {
+    results: ImportItemResult[];
+}
+/**
+ * Options for import operations
+ */
+export interface ImportOptions {
+    pubmedConfig?: PubmedConfig;
+}
+/**
+ * Import references from content string
+ *
+ * @param content - The content to parse
+ * @param format - The format of the content (or "auto" for detection)
+ * @param options - Import options
+ * @returns Import result with parsed items
+ */
+export declare function importFromContent(content: string, format: InputFormat | "auto", _options: ImportOptions): Promise<ImportResult>;
+/**
+ * Import references from identifier strings (PMID or DOI)
+ *
+ * @param identifiers - Array of identifier strings
+ * @param options - Import options (requires pubmedConfig for PMID fetching)
+ * @returns Import result with fetched items
+ */
+export declare function importFromIdentifiers(identifiers: string[], options: ImportOptions): Promise<ImportResult>;
+/**
+ * Options for importFromInputs
+ */
+export interface ImportInputsOptions extends ImportOptions {
+    /** Explicit format specification (default: auto) */
+    format?: InputFormat | "auto";
+    /** Content from stdin (if provided, processed before file/identifier inputs) */
+    stdinContent?: string;
+}
+export declare function importFromInputs(inputs: string[], options: ImportInputsOptions): Promise<ImportResult>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/features/import/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../src/features/import/importer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAI5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAwMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAAG,MAAM,EAC5B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,oDAAoD;IACpD,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAsGD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAiCvB"}

package/dist/features/import/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Import feature public API
+ *
+ * Provides unified entry point for importing references from various formats.
+ */
+export { importFromInputs } from "./importer.js";
+export type { ImportInputsOptions, ImportItemResult, ImportResult } from "./importer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/import/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/import/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/features/import/normalizer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * DOI normalizer module
+ *
+ * Normalizes DOI identifiers by:
+ * - Removing URL prefixes (doi.org, dx.doi.org)
+ * - Trimming whitespace
+ */
+/**
+ * Normalize a DOI identifier
+ *
+ * @param doi - DOI string, possibly with URL prefix
+ * @returns Normalized DOI (10.xxx/xxx format)
+ */
+export declare function normalizeDoi(doi: string): string;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/features/import/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../src/features/import/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBhD"}

package/dist/features/import/parser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Parser module for BibTeX and RIS formats
+ *
+ * Uses citation-js plugins for parsing:
+ * - @citation-js/plugin-bibtex for BibTeX
+ * - @citation-js/plugin-ris for RIS
+ */
+import "@citation-js/plugin-bibtex";
+import "@citation-js/plugin-ris";
+import type { CslItem } from "../../core/csl-json/types.js";
+/**
+ * Result of a parse operation
+ */
+export type ParseResult = {
+    success: boolean;
+    items: CslItem[];
+    error?: string;
+};
+/**
+ * Parse BibTeX content to CSL-JSON
+ *
+ * @param content - BibTeX content string
+ * @returns Parse result with CSL-JSON items
+ */
+export declare function parseBibtex(content: string): ParseResult;
+/**
+ * Parse RIS content to CSL-JSON
+ *
+ * @param content - RIS content string
+ * @returns Parse result with CSL-JSON items
+ */
+export declare function parseRis(content: string): ParseResult;
+//# sourceMappingURL=parser.d.ts.map

package/dist/features/import/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/features/import/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,4BAA4B,CAAC;AACpC,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAErD"}

package/dist/features/import/rate-limiter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Rate limiter module for API calls
+ *
+ * Uses factory + lazy initialization singleton pattern:
+ * - RateLimiter class: Delay-based rate limiting with configurable requests/second
+ * - getRateLimiter(api, config): Returns singleton per API type
+ * - resetRateLimiters(): Clears singletons for test isolation
+ */
+/**
+ * API types supported by the rate limiter
+ */
+export type ApiType = "pubmed" | "crossref";
+/**
+ * Configuration for rate limiter
+ */
+export interface RateLimiterConfig {
+    pubmedApiKey?: string;
+}
+/**
+ * Rate limiter interface
+ */
+export interface RateLimiter {
+    readonly requestsPerSecond: number;
+    readonly intervalMs: number;
+    readonly lastRequestTime: number;
+    acquire(): Promise<void>;
+}
+/**
+ * Create a new rate limiter instance
+ */
+export declare function createRateLimiter(options: {
+    requestsPerSecond: number;
+}): RateLimiter;
+/**
+ * Get singleton rate limiter for the specified API type
+ *
+ * Note: Configuration is only used on first call. Subsequent calls
+ * return the existing singleton regardless of config changes.
+ */
+export declare function getRateLimiter(api: ApiType, config: RateLimiterConfig): RateLimiter;
+/**
+ * Reset all rate limiter singletons (for test isolation)
+ */
+export declare function resetRateLimiters(): void;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/features/import/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/features/import/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AA2DD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,WAAW,CAEd;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAWnF;AAcD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/features/operations/add.d.ts

@@ -0,0 +1,65 @@
+import type { Library } from "../../core/library.js";
+import type { InputFormat } from "../import/detector.js";
+import type { PubmedConfig } from "../import/fetcher.js";
+/**
+ * Options for adding references
+ */
+export interface AddReferencesOptions {
+    /** Skip duplicate detection */
+    force?: boolean;
+    /** Explicit input format (default: auto) */
+    format?: InputFormat | "auto";
+    /** PubMed API configuration */
+    pubmedConfig?: PubmedConfig;
+    /** Content from stdin (if provided, processed before file/identifier inputs) */
+    stdinContent?: string;
+}
+/**
+ * Information about a successfully added reference
+ */
+export interface AddedItem {
+    id: string;
+    title: string;
+    /** True if the ID was changed due to collision */
+    idChanged?: boolean;
+    /** Original ID before collision resolution */
+    originalId?: string;
+}
+/**
+ * Information about a failed import
+ */
+export interface FailedItem {
+    source: string;
+    error: string;
+}
+/**
+ * Information about a skipped duplicate
+ */
+export interface SkippedItem {
+    source: string;
+    existingId: string;
+}
+/**
+ * Result of addReferences operation
+ */
+export interface AddReferencesResult {
+    added: AddedItem[];
+    failed: FailedItem[];
+    skipped: SkippedItem[];
+}
+/**
+ * Add references to a library from various input sources.
+ *
+ * This function orchestrates:
+ * 1. Import from inputs (files or identifiers)
+ * 2. Duplicate detection (unless force=true)
+ * 3. ID collision resolution
+ * 4. Library save
+ *
+ * @param inputs - File paths or identifiers (PMID, DOI)
+ * @param library - Target library
+ * @param options - Add options
+ * @returns Result with added, failed, and skipped items
+ */
+export declare function addReferences(inputs: string[], library: Library, options: AddReferencesOptions): Promise<AddReferencesResult>;
+//# sourceMappingURL=add.d.ts.map

package/dist/features/operations/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/features/operations/add.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}

package/dist/features/operations/cite.d.ts

@@ -0,0 +1,48 @@
+import type { Library } from "../../core/library.js";
+/**
+ * Options for citeReferences operation
+ */
+export interface CiteOperationOptions {
+    /** Reference IDs or UUIDs to cite */
+    identifiers: string[];
+    /** If true, identifiers are treated as UUIDs; otherwise as IDs (default: false) */
+    byUuid?: boolean;
+    /** CSL style name or path to CSL file */
+    style?: string;
+    /** Path to custom CSL file */
+    cslFile?: string;
+    /** Locale for citation formatting (default: "en-US") */
+    locale?: string;
+    /** Output format (default: "text") */
+    format?: "text" | "html" | "rtf";
+    /** If true, generate in-text citation instead of bibliography */
+    inText?: boolean;
+}
+/**
+ * Result for a single citation
+ */
+export type CiteItemResult = {
+    success: true;
+    identifier: string;
+    citation: string;
+} | {
+    success: false;
+    identifier: string;
+    error: string;
+};
+/**
+ * Result of citeReferences operation
+ */
+export interface CiteResult {
+    /** Results for each identifier */
+    results: CiteItemResult[];
+}
+/**
+ * Generate citations for references.
+ *
+ * @param library - The library to cite from
+ * @param options - Citation options including identifiers and style settings
+ * @returns Results array with citation or error for each identifier
+ */
+export declare function citeReferences(library: Library, options: CiteOperationOptions): Promise<CiteResult>;
+//# sourceMappingURL=cite.d.ts.map

package/dist/features/operations/cite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cite.d.ts","sourceRoot":"","sources":["../../../src/features/operations/cite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQrD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAuED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAerB"}

package/dist/features/operations/list.d.ts

@@ -0,0 +1,28 @@
+import type { Library } from "../../core/library.js";
+/**
+ * Output format options for list operation
+ */
+export type ListFormat = "pretty" | "json" | "bibtex" | "ids-only" | "uuid";
+/**
+ * Options for listReferences operation
+ */
+export interface ListOptions {
+    /** Output format (default: "pretty") */
+    format?: ListFormat;
+}
+/**
+ * Result of listReferences operation
+ */
+export interface ListResult {
+    /** Formatted strings for each reference */
+    items: string[];
+}
+/**
+ * List all references from the library with specified format.
+ *
+ * @param library - The library to list references from
+ * @param options - Formatting options
+ * @returns Formatted strings for each reference
+ */
+export declare function listReferences(library: Library, options: ListOptions): ListResult;
+//# sourceMappingURL=list.d.ts.map

package/dist/features/operations/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/features/operations/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU,CA6BjF"}

package/dist/features/operations/remove.d.ts

@@ -0,0 +1,29 @@
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { Library } from "../../core/library.js";
+/**
+ * Options for removeReference operation
+ */
+export interface RemoveOperationOptions {
+    /** Reference ID or UUID */
+    identifier: string;
+    /** If true, identifier is treated as UUID; otherwise as ID (default: false) */
+    byUuid?: boolean;
+}
+/**
+ * Result of removeReference operation
+ */
+export interface RemoveResult {
+    /** Whether the reference was removed */
+    removed: boolean;
+    /** The removed item (if found) */
+    item?: CslItem;
+}
+/**
+ * Remove a reference from the library.
+ *
+ * @param library - The library to remove from
+ * @param options - Remove options including identifier and lookup method
+ * @returns Result indicating success and the removed item
+ */
+export declare function removeReference(library: Library, options: RemoveOperationOptions): Promise<RemoveResult>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/features/operations/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/features/operations/remove.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAqBvB"}

package/dist/features/operations/search.d.ts

@@ -0,0 +1,30 @@
+import type { Library } from "../../core/library.js";
+/**
+ * Output format options for search operation
+ */
+export type SearchFormat = "pretty" | "json" | "bibtex" | "ids-only" | "uuid";
+/**
+ * Options for searchReferences operation
+ */
+export interface SearchOperationOptions {
+    /** Search query string */
+    query: string;
+    /** Output format (default: "pretty") */
+    format?: SearchFormat;
+}
+/**
+ * Result of searchReferences operation
+ */
+export interface SearchResult {
+    /** Formatted strings for each matching reference */
+    items: string[];
+}
+/**
+ * Search references in the library and return formatted results.
+ *
+ * @param library - The library to search in
+ * @param options - Search query and formatting options
+ * @returns Formatted strings for each matching reference
+ */
+export declare function searchReferences(library: Library, options: SearchOperationOptions): SearchResult;
+//# sourceMappingURL=search.d.ts.map

package/dist/features/operations/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/features/operations/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAMrD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,YAAY,CA2ChG"}

package/dist/features/operations/update.d.ts

@@ -0,0 +1,39 @@
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { Library } from "../../core/library.js";
+/**
+ * Options for updateReference operation
+ */
+export interface UpdateOperationOptions {
+    /** Reference ID or UUID */
+    identifier: string;
+    /** If true, identifier is treated as UUID; otherwise as ID (default: false) */
+    byUuid?: boolean;
+    /** Partial updates to apply to the reference */
+    updates: Partial<CslItem>;
+    /** How to handle ID collision: 'fail' (default) or 'suffix' */
+    onIdCollision?: "fail" | "suffix";
+}
+/**
+ * Result of updateReference operation
+ */
+export interface UpdateOperationResult {
+    /** Whether the update was successful */
+    updated: boolean;
+    /** The updated item (if successful) */
+    item?: CslItem;
+    /** True if ID collision occurred (only when updated=false and onIdCollision='fail') */
+    idCollision?: boolean;
+    /** True if the ID was changed due to collision resolution */
+    idChanged?: boolean;
+    /** The new ID after collision resolution (only when idChanged=true) */
+    newId?: string;
+}
+/**
+ * Update a reference in the library.
+ *
+ * @param library - The library to update
+ * @param options - Update options including identifier, updates, and collision handling
+ * @returns Result indicating success and the updated item
+ */
+export declare function updateReference(library: Library, options: UpdateOperationOptions): Promise<UpdateOperationResult>;
+//# sourceMappingURL=update.d.ts.map

package/dist/features/operations/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/features/operations/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAqChC"}

package/dist/index.js

@@ -1,5 +1,7 @@
-import { C as CslLibrarySchema, c as computeFileHash, a as computeHash, b as backupConfigSchema, d as configSchema, e as defaultConfig, g as getDefaultBackupDirectory, f as getDefaultCurrentDirConfigFilename, h as getDefaultLibraryPath, i as getDefaultUserConfigPath, l as loadConfig, j as logLevelSchema, n as normalizePartialConfig, p as partialConfigSchema, w as watchConfigSchema, k as normalize, s as search, m as sortResults, t as tokenize, o as detectDuplicate } from "./chunks/detector-BF8Mcc72.js";
-import { q, L, R, D, E, x, y, A, B, z, r, u, v } from "./chunks/detector-BF8Mcc72.js";
+import { c as computeFileHash, a as computeHash, b as backupConfigSchema, d as configSchema, e as defaultConfig, g as getDefaultBackupDirectory, f as getDefaultCurrentDirConfigFilename, h as getDefaultLibraryPath, i as getDefaultUserConfigPath, l as loadConfig, j as logLevelSchema, n as normalizePartialConfig, p as partialConfigSchema, w as watchConfigSchema } from "./chunks/loader-mQ25o6cV.js";
+import { L, R, v, x, o, q, t, u, r, k, s, m } from "./chunks/loader-mQ25o6cV.js";
+import { C as CslLibrarySchema, n as normalize, s as search, a as sortResults, t as tokenize, d as detectDuplicate } from "./chunks/detector-DHztTaFY.js";
+import { b } from "./chunks/detector-DHztTaFY.js";
 import * as fs from "node:fs/promises";
 import { mkdir, readFile, copyFile, stat, unlink, readdir } from "node:fs/promises";
 import * as path from "node:path";
@@ -93,7 +95,7 @@ async function listBackups(libraryName) {
       return { file, mtime: stats.mtimeMs };
     })
   );
-  filesWithStats.sort((a, b) => b.mtime - a.mtime);
+  filesWithStats.sort((a, b2) => b2.mtime - a.mtime);
   return filesWithStats.map((f) => f.file);
 }
 async function cleanupOldBackups(libraryName, options) {
@@ -157,8 +159,8 @@ function getItemUuid(item) {
 function getTimestamp(item) {
   return item.custom?.timestamp || item.custom?.created_at || "1970-01-01T00:00:00.000Z";
 }
-function deepEqual(a, b) {
-  return JSON.stringify(a) === JSON.stringify(b);
+function deepEqual(a, b2) {
+  return JSON.stringify(a) === JSON.stringify(b2);
 }
 function resolveFieldConflict(localValue, remoteValue, localTimestamp, remoteTimestamp, options) {
   if (localTimestamp > remoteTimestamp) {
@@ -535,7 +537,7 @@ class FileWatcher extends EventEmitter {
 }
 export {
   index$3 as Config,
-  q as CslItemSchema,
+  b as CslItemSchema,
   CslLibrarySchema,
   index$1 as Duplicate,
   FileWatcher,
@@ -544,16 +546,16 @@ export {
   R as Reference,
   index$2 as Search,
   index$4 as Utils,
-  D as ensureCustomMetadata,
-  E as extractUuidFromCustom,
-  x as generateId,
-  y as generateIdWithCollisionCheck,
-  A as generateUuid,
-  B as isValidUuid,
-  z as normalizeText,
-  r as parseCslJson,
-  u as serializeCslJson,
+  v as ensureCustomMetadata,
+  x as extractUuidFromCustom,
+  o as generateId,
+  q as generateIdWithCollisionCheck,
+  t as generateUuid,
+  u as isValidUuid,
+  r as normalizeText,
+  k as parseCslJson,
+  s as serializeCslJson,
   validateCslJson,
-  v as writeCslJson
+  m as writeCslJson
 };
 //# sourceMappingURL=index.js.map