@ncukondo/reference-manager 0.1.0 → 0.4.0

package/dist/features/format/pretty.d.ts

@@ -0,0 +1,6 @@
+import type { CslItem } from "../../core/csl-json/types.js";
+/**
+ * Format references in pretty-printed format
+ */
+export declare function formatPretty(items: CslItem[]): string;
+//# sourceMappingURL=pretty.d.ts.map

package/dist/features/format/pretty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty.d.ts","sourceRoot":"","sources":["../../../src/features/format/pretty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AA+E5D;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAMrD"}

package/dist/features/fulltext/filename.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Fulltext filename generation
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+import { type FulltextType } from "./types.js";
+/**
+ * Generate a filename for a fulltext file.
+ *
+ * Format: {id}[-PMID{PMID}]-{uuid}.{ext}
+ *
+ * @param item - CSL item to generate filename for
+ * @param type - Fulltext type (pdf or markdown)
+ * @returns Generated filename
+ * @throws Error if custom.uuid is missing
+ */
+export declare function generateFulltextFilename(item: CslItem, type: FulltextType): string;
+//# sourceMappingURL=filename.d.ts.map

package/dist/features/fulltext/filename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.d.ts","sourceRoot":"","sources":["../../../src/features/fulltext/filename.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAkBlF"}

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

@@ -0,0 +1,7 @@
+/**
+ * Fulltext management exports
+ */
+export * from "./types.js";
+export { generateFulltextFilename } from "./filename.js";
+export { FulltextManager, FulltextIOError, FulltextNotAttachedError, type AttachOptions, type AttachResult, type DetachOptions, type DetachResult, } from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/fulltext/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC"}

package/dist/features/fulltext/manager.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Fulltext file management
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { FulltextType } from "./types.js";
+/**
+ * Error thrown when fulltext I/O operation fails
+ */
+export declare class FulltextIOError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Error thrown when trying to detach non-attached fulltext
+ */
+export declare class FulltextNotAttachedError extends Error {
+    readonly itemId: string;
+    readonly type: FulltextType;
+    constructor(itemId: string, type: FulltextType);
+}
+/**
+ * Options for attachFile
+ */
+export interface AttachOptions {
+    /** Move file instead of copy (default: false) */
+    move?: boolean;
+    /** Overwrite existing attachment without confirmation (default: false) */
+    force?: boolean;
+}
+/**
+ * Result of attachFile operation
+ */
+export interface AttachResult {
+    /** Generated filename */
+    filename: string;
+    /** Existing filename if already attached (when force=false) */
+    existingFile?: string;
+    /** Whether existing file was overwritten */
+    overwritten: boolean;
+    /** Old filename that was deleted (when force=true and filename changed) */
+    deletedOldFile?: string;
+}
+/**
+ * Options for detachFile
+ */
+export interface DetachOptions {
+    /** Delete file from disk (default: false, metadata-only detach) */
+    delete?: boolean;
+}
+/**
+ * Result of detachFile operation
+ */
+export interface DetachResult {
+    /** Detached filename */
+    filename: string;
+    /** Whether file was deleted from disk */
+    deleted: boolean;
+}
+/**
+ * Manages fulltext file operations
+ */
+export declare class FulltextManager {
+    private readonly fulltextDirectory;
+    constructor(fulltextDirectory: string);
+    /**
+     * Ensure the fulltext directory exists
+     */
+    ensureDirectory(): Promise<void>;
+    /**
+     * Attach a file to a reference
+     */
+    attachFile(item: CslItem, sourcePath: string, type: FulltextType, options?: AttachOptions): Promise<AttachResult>;
+    /**
+     * Validate that source file exists
+     */
+    private validateSourceFile;
+    /**
+     * Delete old file if force mode and filename changed
+     * @returns Deleted filename or undefined
+     */
+    private deleteOldFileIfNeeded;
+    /**
+     * Copy or move file to destination
+     */
+    private copyOrMoveFile;
+    /**
+     * Get the full path for an attached file
+     * @returns Full path or null if not attached
+     */
+    getFilePath(item: CslItem, type: FulltextType): string | null;
+    /**
+     * Detach a file from a reference
+     */
+    detachFile(item: CslItem, type: FulltextType, options?: DetachOptions): Promise<DetachResult>;
+    /**
+     * Get list of attached fulltext types
+     */
+    getAttachedTypes(item: CslItem): FulltextType[];
+    /**
+     * Check if item has attachment
+     * @param type Optional type to check; if omitted, checks for any attachment
+     */
+    hasAttachment(item: CslItem, type?: FulltextType): boolean;
+    /**
+     * Get existing filename from item metadata
+     */
+    private getExistingFilename;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/features/fulltext/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/features/fulltext/manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,KAAK,CAAC,EAAE,KAAK;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;aAE/B,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,YAAY;gBADlB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY;CAKrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,MAAM;IAEtD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAyCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;OAGG;YACW,qBAAqB;IAkBnC;;OAEG;YACW,cAAc;IAgB5B;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAQ7D;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAuBxB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,EAAE;IAc/C;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO;IAO1D;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/features/fulltext/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fulltext management types
+ */
+/**
+ * Supported fulltext file types
+ */
+export type FulltextType = "pdf" | "markdown";
+/**
+ * File extensions for each fulltext type
+ */
+export declare const FULLTEXT_EXTENSIONS: Record<FulltextType, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/features/fulltext/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/fulltext/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,UAAU,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAG5D,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Response cache for PMID and DOI metadata
+ *
+ * In-memory cache with TTL to avoid redundant API calls.
+ * - Per ADR-001: No persistent cache files on disk
+ * - Cache is warm during interactive sessions (server mode)
+ * - CLI invocations start fresh
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    /** Time-to-live in milliseconds (default: 1 hour) */
+    ttlMs?: number;
+}
+/**
+ * Get cached PMID result
+ */
+export declare function getPmidFromCache(pmid: string): CslItem | undefined;
+/**
+ * Cache PMID result
+ */
+export declare function cachePmidResult(pmid: string, item: CslItem, config?: CacheConfig): void;
+/**
+ * Get cached DOI result
+ */
+export declare function getDoiFromCache(doi: string): CslItem | undefined;
+/**
+ * Cache DOI result
+ */
+export declare function cacheDoiResult(doi: string, item: CslItem, config?: CacheConfig): void;
+/**
+ * Reset all caches (for test isolation)
+ */
+export declare function resetCache(): void;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/features/import/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAK5D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyDD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAEvF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAErF;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

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 { ILibrary } from "../../core/library-interface.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: ILibrary, 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,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,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,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}

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

@@ -0,0 +1,48 @@
+import type { ILibrary } from "../../core/library-interface.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: ILibrary, 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,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAQhE;;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;AAsED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAerB"}