@ncukondo/search-hub 0.1.0

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sources":["../../src/config/loader.ts"],"sourcesContent":["import { readFile, writeFile, mkdir } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { parse as parseToml, stringify as stringifyToml } from '@iarna/toml';\nimport { ConfigSchema, type Config } from './schema.js';\nimport { getDefaultConfig } from './defaults.js';\nimport { applyEnvVars } from './env.js';\nimport { getDefaultConfigPath, getDefaultSessionsDir } from './paths.js';\nimport { deepMerge, type DeepPartial } from '../utils/deep-merge.js';\nimport { expandPath } from '../utils/path.js';\n\nexport type RawConfig = Partial<Config>;\n\n/**\n * Options for loadConfig function.\n */\nexport interface LoadConfigOptions {\n  /** Path to global config file (default: platform-specific via getDefaultConfigPath()) */\n  globalConfigPath?: string;\n  /** Path to local config file (default: ./search-hub.config.toml) */\n  localConfigPath?: string;\n  /** CLI options to apply (highest priority) */\n  cliOptions?: DeepPartial<Config>;\n}\n\n/**\n * Load and parse a TOML config file.\n * Returns empty object if file doesn't exist.\n * Throws with clear message if TOML is invalid.\n */\nexport async function loadTomlFile(path: string): Promise<RawConfig> {\n  let content: string;\n\n  try {\n    content = await readFile(path, 'utf-8');\n  } catch (error) {\n    // File doesn't exist or can't be read\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n      return {};\n    }\n    throw error;\n  }\n\n  // Empty file\n  if (!content.trim()) {\n    return {};\n  }\n\n  try {\n    return parseToml(content) as RawConfig;\n  } catch (error) {\n    throw new Error(\n      `Invalid TOML in ${path}: ${error instanceof Error ? error.message : String(error)}`\n    );\n  }\n}\n\n/**\n * Default local config file path.\n */\nconst DEFAULT_LOCAL_CONFIG_PATH = './search-hub.config.toml';\n\n/**\n * Load configuration from all sources and merge them.\n *\n * Priority (highest to lowest):\n * 1. CLI options\n * 2. Environment variables\n * 3. Local config (./search-hub.config.toml)\n * 4. Global config (platform-specific, e.g. ~/.config/search-hub/config.toml on Linux)\n * 5. Default values\n */\nexport async function loadConfig(options: LoadConfigOptions = {}): Promise<Config> {\n  const {\n    globalConfigPath = getDefaultConfigPath(),\n    localConfigPath = DEFAULT_LOCAL_CONFIG_PATH,\n    cliOptions,\n  } = options;\n\n  // 1. Start with defaults\n  let config = getDefaultConfig();\n\n  // 2. Load and merge global config\n  const expandedGlobalPath = expandPath(globalConfigPath);\n  const globalConfig = await loadTomlFile(expandedGlobalPath);\n  config = deepMerge(config, globalConfig as DeepPartial<Config>);\n\n  // 3. Load and merge local config\n  const localConfig = await loadTomlFile(localConfigPath);\n  config = deepMerge(config, localConfig as DeepPartial<Config>);\n\n  // 4. Apply environment variables\n  config = applyEnvVars(config);\n\n  // 5. Apply CLI options (if provided)\n  if (cliOptions) {\n    config = deepMerge(config, cliOptions);\n  }\n\n  // 6. Validate\n  config = ConfigSchema.parse(config);\n\n  // 7. Resolve empty session.directory to platform default\n  if (!config.session.directory) {\n    config.session.directory = getDefaultSessionsDir();\n  }\n\n  return config;\n}\n\n/**\n * Options for saveConfig function.\n */\nexport interface SaveConfigOptions {\n  /** Path to save config file (default: platform-specific via getDefaultConfigPath()) */\n  path?: string;\n  /** Create directory if it doesn't exist (default: true) */\n  createDir?: boolean;\n}\n\n// Re-define JsonMap type to match @iarna/toml's expected input\n// This is necessary because the library's JsonMap type is not exported\ntype TomlValue = boolean | number | string | Date | TomlMap | TomlValue[];\ninterface TomlMap {\n  [key: string]: TomlValue;\n}\n\n/**\n * Save configuration to a TOML file.\n *\n * @param config - Configuration object to save\n * @param options - Save options\n * @throws Error if config is invalid or file write fails\n */\nexport async function saveConfig(\n  config: Config,\n  options: SaveConfigOptions = {}\n): Promise<void> {\n  const {\n    path = getDefaultConfigPath(),\n    createDir = true,\n  } = options;\n\n  // Validate config before saving\n  ConfigSchema.parse(config);\n\n  // Expand path and ensure directory exists\n  const expandedPath = expandPath(path);\n  if (createDir) {\n    await mkdir(dirname(expandedPath), { recursive: true });\n  }\n\n  // Convert to TOML and write\n  // Config structure is compatible with TOML's JsonMap type\n  // The cast is safe because Config only contains TOML-compatible types\n  const tomlContent = stringifyToml(config as TomlMap);\n  await writeFile(expandedPath, tomlContent, 'utf-8');\n}\n"],"names":["parseToml","stringifyToml"],"mappings":";;;;;;;;;AA6BA,eAAsB,aAAa,MAAkC;AACnE,MAAI;AAEJ,MAAI;AACF,cAAU,MAAM,SAAS,MAAM,OAAO;AAAA,EACxC,SAAS,OAAO;AAEd,QAAK,MAAgC,SAAS,UAAU;AACtD,aAAO,CAAA;AAAA,IACT;AACA,UAAM;AAAA,EACR;AAGA,MAAI,CAAC,QAAQ,QAAQ;AACnB,WAAO,CAAA;AAAA,EACT;AAEA,MAAI;AACF,WAAOA,MAAU,OAAO;AAAA,EAC1B,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR,mBAAmB,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,IAAA;AAAA,EAEtF;AACF;AAKA,MAAM,4BAA4B;AAYlC,eAAsB,WAAW,UAA6B,IAAqB;AACjF,QAAM;AAAA,IACJ,mBAAmB,qBAAA;AAAA,IACnB,kBAAkB;AAAA,IAClB;AAAA,EAAA,IACE;AAGJ,MAAI,SAAS,iBAAA;AAGb,QAAM,qBAAqB,WAAW,gBAAgB;AACtD,QAAM,eAAe,MAAM,aAAa,kBAAkB;AAC1D,WAAS,UAAU,QAAQ,YAAmC;AAG9D,QAAM,cAAc,MAAM,aAAa,eAAe;AACtD,WAAS,UAAU,QAAQ,WAAkC;AAG7D,WAAS,aAAa,MAAM;AAG5B,MAAI,YAAY;AACd,aAAS,UAAU,QAAQ,UAAU;AAAA,EACvC;AAGA,WAAS,aAAa,MAAM,MAAM;AAGlC,MAAI,CAAC,OAAO,QAAQ,WAAW;AAC7B,WAAO,QAAQ,YAAY,sBAAA;AAAA,EAC7B;AAEA,SAAO;AACT;AA0BA,eAAsB,WACpB,QACA,UAA6B,IACd;AACf,QAAM;AAAA,IACJ,OAAO,qBAAA;AAAA,IACP,YAAY;AAAA,EAAA,IACV;AAGJ,eAAa,MAAM,MAAM;AAGzB,QAAM,eAAe,WAAW,IAAI;AACpC,MAAI,WAAW;AACb,UAAM,MAAM,QAAQ,YAAY,GAAG,EAAE,WAAW,MAAM;AAAA,EACxD;AAKA,QAAM,cAAcC,UAAc,MAAiB;AACnD,QAAM,UAAU,cAAc,aAAa,OAAO;AACpD;"}

package/dist/config/paths.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Get the config directory for search-hub.
+ * - Linux: ~/.config/search-hub
+ * - macOS: ~/Library/Preferences/search-hub
+ * - Windows: %APPDATA%\search-hub\Config
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get the data directory for search-hub.
+ * - Linux: ~/.local/share/search-hub
+ * - macOS: ~/Library/Application Support/search-hub
+ * - Windows: %LOCALAPPDATA%\search-hub\Data
+ */
+export declare function getDataDir(): string;
+/**
+ * Get the default config file path.
+ */
+export declare function getDefaultConfigPath(): string;
+/**
+ * Get the default sessions directory.
+ */
+export declare function getDefaultSessionsDir(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/config/paths.js

@@ -0,0 +1,22 @@
+import envPaths from "../node_modules/env-paths/index.js";
+import { join } from "node:path";
+const paths = envPaths("search-hub", { suffix: "" });
+function getConfigDir() {
+  return paths.config;
+}
+function getDataDir() {
+  return paths.data;
+}
+function getDefaultConfigPath() {
+  return join(paths.config, "config.toml");
+}
+function getDefaultSessionsDir() {
+  return join(paths.data, "sessions");
+}
+export {
+  getConfigDir,
+  getDataDir,
+  getDefaultConfigPath,
+  getDefaultSessionsDir
+};
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sources":["../../src/config/paths.ts"],"sourcesContent":["/**\n * Platform-specific paths using XDG Base Directory spec on Linux,\n * ~/Library on macOS, and AppData on Windows.\n */\nimport envPaths from 'env-paths';\nimport { join } from 'node:path';\n\n// Use empty suffix to get clean 'search-hub' directory names\nconst paths = envPaths('search-hub', { suffix: '' });\n\n/**\n * Get the config directory for search-hub.\n * - Linux: ~/.config/search-hub\n * - macOS: ~/Library/Preferences/search-hub\n * - Windows: %APPDATA%\\search-hub\\Config\n */\nexport function getConfigDir(): string {\n  return paths.config;\n}\n\n/**\n * Get the data directory for search-hub.\n * - Linux: ~/.local/share/search-hub\n * - macOS: ~/Library/Application Support/search-hub\n * - Windows: %LOCALAPPDATA%\\search-hub\\Data\n */\nexport function getDataDir(): string {\n  return paths.data;\n}\n\n/**\n * Get the default config file path.\n */\nexport function getDefaultConfigPath(): string {\n  return join(paths.config, 'config.toml');\n}\n\n/**\n * Get the default sessions directory.\n */\nexport function getDefaultSessionsDir(): string {\n  return join(paths.data, 'sessions');\n}\n"],"names":[],"mappings":";;AAQA,MAAM,QAAQ,SAAS,cAAc,EAAE,QAAQ,IAAI;AAQ5C,SAAS,eAAuB;AACrC,SAAO,MAAM;AACf;AAQO,SAAS,aAAqB;AACnC,SAAO,MAAM;AACf;AAKO,SAAS,uBAA+B;AAC7C,SAAO,KAAK,MAAM,QAAQ,aAAa;AACzC;AAKO,SAAS,wBAAgC;AAC9C,SAAO,KAAK,MAAM,MAAM,UAAU;AACpC;"}

package/dist/config/schema.d.ts

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+/**
+ * Schema for individual provider configuration.
+ * Each provider (PubMed, Scopus, etc.) has similar config options.
+ */
+export declare const ProviderConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    api_key: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    rate_limit: z.ZodDefault<z.ZodNumber>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    retries: z.ZodDefault<z.ZodNumber>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+    inst_token: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProviderConfig = z.infer<typeof ProviderConfigSchema>;
+/**
+ * Main configuration schema for search-hub.
+ * All fields have defaults, so an empty object is valid input.
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    session: z.ZodDefault<z.ZodObject<{
+        directory: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    log: z.ZodDefault<z.ZodObject<{
+        level: z.ZodDefault<z.ZodEnum<{
+            error: "error";
+            debug: "debug";
+            info: "info";
+            warn: "warn";
+        }>>;
+    }, z.core.$strip>>;
+    output: z.ZodDefault<z.ZodObject<{
+        color: z.ZodDefault<z.ZodBoolean>;
+        progress_bar: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    providers: z.ZodDefault<z.ZodObject<{
+        pubmed: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            api_key: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            rate_limit: z.ZodDefault<z.ZodNumber>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+            retries: z.ZodDefault<z.ZodNumber>;
+            max_results: z.ZodDefault<z.ZodNumber>;
+            inst_token: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        eric: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            api_key: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            rate_limit: z.ZodDefault<z.ZodNumber>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+            retries: z.ZodDefault<z.ZodNumber>;
+            max_results: z.ZodDefault<z.ZodNumber>;
+            inst_token: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        arxiv: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            api_key: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            rate_limit: z.ZodDefault<z.ZodNumber>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+            retries: z.ZodDefault<z.ZodNumber>;
+            max_results: z.ZodDefault<z.ZodNumber>;
+            inst_token: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        scopus: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            api_key: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            rate_limit: z.ZodDefault<z.ZodNumber>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+            retries: z.ZodDefault<z.ZodNumber>;
+            max_results: z.ZodDefault<z.ZodNumber>;
+            inst_token: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        wos: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            api_key: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            rate_limit: z.ZodDefault<z.ZodNumber>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+            retries: z.ZodDefault<z.ZodNumber>;
+            max_results: z.ZodDefault<z.ZodNumber>;
+            inst_token: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        embase: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            api_key: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            rate_limit: z.ZodDefault<z.ZodNumber>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+            retries: z.ZodDefault<z.ZodNumber>;
+            max_results: z.ZodDefault<z.ZodNumber>;
+            inst_token: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    integration: z.ZodDefault<z.ZodObject<{
+        reference_manager: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            command: z.ZodDefault<z.ZodString>;
+            auto_register: z.ZodDefault<z.ZodBoolean>;
+            with_abstracts: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof ConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAS/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AASlE;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+DvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+const PROVIDER_DEFAULTS = {
+  enabled: true,
+  rate_limit: 3,
+  timeout: 3e4,
+  retries: 3,
+  max_results: 1e4
+};
+const ProviderConfigSchema = z.object({
+  enabled: z.boolean().default(PROVIDER_DEFAULTS.enabled),
+  api_key: z.string().optional(),
+  email: z.string().email().optional(),
+  rate_limit: z.number().positive().default(PROVIDER_DEFAULTS.rate_limit),
+  timeout: z.number().positive().default(PROVIDER_DEFAULTS.timeout),
+  retries: z.number().int().min(0).default(PROVIDER_DEFAULTS.retries),
+  max_results: z.number().int().positive().default(PROVIDER_DEFAULTS.max_results),
+  inst_token: z.string().optional()
+});
+function getDefaultProviderConfig() {
+  return ProviderConfigSchema.parse({});
+}
+const ConfigSchema = z.object({
+  session: z.object({
+    // Empty string means use platform default (resolved in loader.ts)
+    directory: z.string().default("")
+  }).default(() => ({ directory: "" })),
+  log: z.object({
+    level: z.enum(["debug", "info", "warn", "error"]).default("info")
+  }).default(() => ({ level: "info" })),
+  output: z.object({
+    color: z.boolean().default(true),
+    progress_bar: z.boolean().default(true)
+  }).default(() => ({ color: true, progress_bar: true })),
+  providers: z.object({
+    pubmed: ProviderConfigSchema.default(getDefaultProviderConfig),
+    eric: ProviderConfigSchema.default(getDefaultProviderConfig),
+    arxiv: ProviderConfigSchema.default(getDefaultProviderConfig),
+    scopus: ProviderConfigSchema.default(getDefaultProviderConfig),
+    wos: ProviderConfigSchema.default(getDefaultProviderConfig),
+    embase: ProviderConfigSchema.default(getDefaultProviderConfig)
+  }).default(() => ({
+    pubmed: getDefaultProviderConfig(),
+    eric: getDefaultProviderConfig(),
+    arxiv: getDefaultProviderConfig(),
+    scopus: getDefaultProviderConfig(),
+    wos: getDefaultProviderConfig(),
+    embase: getDefaultProviderConfig()
+  })),
+  integration: z.object({
+    reference_manager: z.object({
+      enabled: z.boolean().default(true),
+      command: z.string().default("ref"),
+      auto_register: z.boolean().default(false),
+      with_abstracts: z.boolean().default(false)
+    }).default(() => ({
+      enabled: true,
+      command: "ref",
+      auto_register: false,
+      with_abstracts: false
+    }))
+  }).default(() => ({
+    reference_manager: {
+      enabled: true,
+      command: "ref",
+      auto_register: false,
+      with_abstracts: false
+    }
+  }))
+});
+export {
+  ConfigSchema,
+  ProviderConfigSchema
+};
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sources":["../../src/config/schema.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Default values for provider configuration.\n */\nconst PROVIDER_DEFAULTS = {\n  enabled: true,\n  rate_limit: 3,\n  timeout: 30000,\n  retries: 3,\n  max_results: 10000,\n} as const;\n\n/**\n * Schema for individual provider configuration.\n * Each provider (PubMed, Scopus, etc.) has similar config options.\n */\nexport const ProviderConfigSchema = z.object({\n  enabled: z.boolean().default(PROVIDER_DEFAULTS.enabled),\n  api_key: z.string().optional(),\n  email: z.string().email().optional(),\n  rate_limit: z.number().positive().default(PROVIDER_DEFAULTS.rate_limit),\n  timeout: z.number().positive().default(PROVIDER_DEFAULTS.timeout),\n  retries: z.number().int().min(0).default(PROVIDER_DEFAULTS.retries),\n  max_results: z.number().int().positive().default(PROVIDER_DEFAULTS.max_results),\n  inst_token: z.string().optional(),\n});\n\nexport type ProviderConfig = z.infer<typeof ProviderConfigSchema>;\n\n/**\n * Get default provider config object.\n */\nfunction getDefaultProviderConfig(): ProviderConfig {\n  return ProviderConfigSchema.parse({});\n}\n\n/**\n * Main configuration schema for search-hub.\n * All fields have defaults, so an empty object is valid input.\n */\nexport const ConfigSchema = z.object({\n  session: z\n    .object({\n      // Empty string means use platform default (resolved in loader.ts)\n      directory: z.string().default(''),\n    })\n    .default(() => ({ directory: '' })),\n\n  log: z\n    .object({\n      level: z.enum(['debug', 'info', 'warn', 'error']).default('info'),\n    })\n    .default(() => ({ level: 'info' as const })),\n\n  output: z\n    .object({\n      color: z.boolean().default(true),\n      progress_bar: z.boolean().default(true),\n    })\n    .default(() => ({ color: true, progress_bar: true })),\n\n  providers: z\n    .object({\n      pubmed: ProviderConfigSchema.default(getDefaultProviderConfig),\n      eric: ProviderConfigSchema.default(getDefaultProviderConfig),\n      arxiv: ProviderConfigSchema.default(getDefaultProviderConfig),\n      scopus: ProviderConfigSchema.default(getDefaultProviderConfig),\n      wos: ProviderConfigSchema.default(getDefaultProviderConfig),\n      embase: ProviderConfigSchema.default(getDefaultProviderConfig),\n    })\n    .default(() => ({\n      pubmed: getDefaultProviderConfig(),\n      eric: getDefaultProviderConfig(),\n      arxiv: getDefaultProviderConfig(),\n      scopus: getDefaultProviderConfig(),\n      wos: getDefaultProviderConfig(),\n      embase: getDefaultProviderConfig(),\n    })),\n\n  integration: z\n    .object({\n      reference_manager: z\n        .object({\n          enabled: z.boolean().default(true),\n          command: z.string().default('ref'),\n          auto_register: z.boolean().default(false),\n          with_abstracts: z.boolean().default(false),\n        })\n        .default(() => ({\n          enabled: true,\n          command: 'ref',\n          auto_register: false,\n          with_abstracts: false,\n        })),\n    })\n    .default(() => ({\n      reference_manager: {\n        enabled: true,\n        command: 'ref',\n        auto_register: false,\n        with_abstracts: false,\n      },\n    })),\n});\n\nexport type Config = z.infer<typeof ConfigSchema>;\n"],"names":[],"mappings":";AAKA,MAAM,oBAAoB;AAAA,EACxB,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,SAAS;AAAA,EACT,aAAa;AACf;AAMO,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,SAAS,EAAE,QAAA,EAAU,QAAQ,kBAAkB,OAAO;AAAA,EACtD,SAAS,EAAE,OAAA,EAAS,SAAA;AAAA,EACpB,OAAO,EAAE,OAAA,EAAS,MAAA,EAAQ,SAAA;AAAA,EAC1B,YAAY,EAAE,OAAA,EAAS,WAAW,QAAQ,kBAAkB,UAAU;AAAA,EACtE,SAAS,EAAE,OAAA,EAAS,WAAW,QAAQ,kBAAkB,OAAO;AAAA,EAChE,SAAS,EAAE,OAAA,EAAS,IAAA,EAAM,IAAI,CAAC,EAAE,QAAQ,kBAAkB,OAAO;AAAA,EAClE,aAAa,EAAE,OAAA,EAAS,IAAA,EAAM,WAAW,QAAQ,kBAAkB,WAAW;AAAA,EAC9E,YAAY,EAAE,OAAA,EAAS,SAAA;AACzB,CAAC;AAOD,SAAS,2BAA2C;AAClD,SAAO,qBAAqB,MAAM,EAAE;AACtC;AAMO,MAAM,eAAe,EAAE,OAAO;AAAA,EACnC,SAAS,EACN,OAAO;AAAA;AAAA,IAEN,WAAW,EAAE,OAAA,EAAS,QAAQ,EAAE;AAAA,EAAA,CACjC,EACA,QAAQ,OAAO,EAAE,WAAW,KAAK;AAAA,EAEpC,KAAK,EACF,OAAO;AAAA,IACN,OAAO,EAAE,KAAK,CAAC,SAAS,QAAQ,QAAQ,OAAO,CAAC,EAAE,QAAQ,MAAM;AAAA,EAAA,CACjE,EACA,QAAQ,OAAO,EAAE,OAAO,SAAkB;AAAA,EAE7C,QAAQ,EACL,OAAO;AAAA,IACN,OAAO,EAAE,UAAU,QAAQ,IAAI;AAAA,IAC/B,cAAc,EAAE,QAAA,EAAU,QAAQ,IAAI;AAAA,EAAA,CACvC,EACA,QAAQ,OAAO,EAAE,OAAO,MAAM,cAAc,KAAA,EAAO;AAAA,EAEtD,WAAW,EACR,OAAO;AAAA,IACN,QAAQ,qBAAqB,QAAQ,wBAAwB;AAAA,IAC7D,MAAM,qBAAqB,QAAQ,wBAAwB;AAAA,IAC3D,OAAO,qBAAqB,QAAQ,wBAAwB;AAAA,IAC5D,QAAQ,qBAAqB,QAAQ,wBAAwB;AAAA,IAC7D,KAAK,qBAAqB,QAAQ,wBAAwB;AAAA,IAC1D,QAAQ,qBAAqB,QAAQ,wBAAwB;AAAA,EAAA,CAC9D,EACA,QAAQ,OAAO;AAAA,IACd,QAAQ,yBAAA;AAAA,IACR,MAAM,yBAAA;AAAA,IACN,OAAO,yBAAA;AAAA,IACP,QAAQ,yBAAA;AAAA,IACR,KAAK,yBAAA;AAAA,IACL,QAAQ,yBAAA;AAAA,EAAyB,EACjC;AAAA,EAEJ,aAAa,EACV,OAAO;AAAA,IACN,mBAAmB,EAChB,OAAO;AAAA,MACN,SAAS,EAAE,UAAU,QAAQ,IAAI;AAAA,MACjC,SAAS,EAAE,SAAS,QAAQ,KAAK;AAAA,MACjC,eAAe,EAAE,UAAU,QAAQ,KAAK;AAAA,MACxC,gBAAgB,EAAE,QAAA,EAAU,QAAQ,KAAK;AAAA,IAAA,CAC1C,EACA,QAAQ,OAAO;AAAA,MACd,SAAS;AAAA,MACT,SAAS;AAAA,MACT,eAAe;AAAA,MACf,gBAAgB;AAAA,IAAA,EAChB;AAAA,EAAA,CACL,EACA,QAAQ,OAAO;AAAA,IACd,mBAAmB;AAAA,MACjB,SAAS;AAAA,MACT,SAAS;AAAA,MACT,eAAe;AAAA,MACf,gBAAgB;AAAA,IAAA;AAAA,EAClB,EACA;AACN,CAAC;"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * search-hub library exports
+ *
+ * This module provides programmatic access to search-hub functionality
+ * for use as a library in other projects.
+ */
+export * from './query/index.js';
+export * from './config/index.js';
+export * from './session/index.js';
+export * from './providers/base/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,54 @@
+import { parseQueryFile, parseQueryString } from "./query/parser.js";
+import { ValidationError, fieldTypeSchema, filtersSchema, formatValidationErrors, overrideBlockSchema, queryBlockSchema, queryFileSchema, termBlockSchema, validateQueryFile } from "./query/validator.js";
+import { loadConfig, saveConfig } from "./config/loader.js";
+import { ConfigSchema } from "./config/schema.js";
+import { DEFAULT_CONFIG, getDefaultConfig } from "./config/defaults.js";
+import { createSession, generateSessionId, getResumableProviders, listSessions, loadSession, sanitizeName, saveSession, sessionExists, updateDatabaseStatus, updateSessionStatus } from "./session/manager.js";
+import { SessionLogger } from "./session/logger.js";
+import { createProviderError, isAuthError, isProviderError, isRateLimitError } from "./providers/base/types.js";
+import { BaseProvider, deserializeState, serializeState } from "./providers/base/provider.js";
+import { RateLimiter } from "./providers/base/rate-limiter.js";
+import { ProviderRegistry, createProviderRegistry, globalRegistry } from "./providers/base/registry.js";
+import { MockProvider } from "./providers/base/mock-provider.js";
+export {
+  BaseProvider,
+  ConfigSchema,
+  DEFAULT_CONFIG,
+  MockProvider,
+  ProviderRegistry,
+  RateLimiter,
+  SessionLogger,
+  ValidationError,
+  createProviderError,
+  createProviderRegistry,
+  createSession,
+  deserializeState,
+  fieldTypeSchema,
+  filtersSchema,
+  formatValidationErrors,
+  generateSessionId,
+  getDefaultConfig,
+  getResumableProviders,
+  globalRegistry,
+  isAuthError,
+  isProviderError,
+  isRateLimitError,
+  listSessions,
+  loadConfig,
+  loadSession,
+  overrideBlockSchema,
+  parseQueryFile,
+  parseQueryString,
+  queryBlockSchema,
+  queryFileSchema,
+  sanitizeName,
+  saveConfig,
+  saveSession,
+  serializeState,
+  sessionExists,
+  termBlockSchema,
+  updateDatabaseStatus,
+  updateSessionStatus,
+  validateQueryFile
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/integration/ref-cli.d.ts

@@ -0,0 +1,41 @@
+import { RefAddOutput } from './types.js';
+/**
+ * Error thrown by ref CLI operations.
+ */
+export declare class RefCliError extends Error {
+    readonly code: string;
+    cause: Error | undefined;
+    constructor(message: string, code: string, cause?: Error);
+}
+/**
+ * Check if the ref command is available.
+ */
+export declare function checkRefAvailable(): Promise<boolean>;
+/**
+ * Check if npm is available.
+ */
+export declare function checkNpmAvailable(): Promise<boolean>;
+/**
+ * Install reference-manager globally via npm.
+ */
+export declare function installRefManager(): Promise<void>;
+/**
+ * Options for ref CLI commands.
+ */
+export interface RefCliOptions {
+    /** Path to the library file (uses --library option) */
+    libraryPath?: string;
+}
+/**
+ * Execute ref add command and return parsed output.
+ */
+export declare function refAdd(id: string, options?: RefCliOptions): Promise<RefAddOutput>;
+/**
+ * Execute ref update command to update a field.
+ */
+export declare function refUpdate(id: string, field: string, value: string, options?: RefCliOptions): Promise<void>;
+/**
+ * Execute ref export command and return the entry data.
+ */
+export declare function refExport(id: string, options?: RefCliOptions): Promise<unknown>;
+//# sourceMappingURL=ref-cli.d.ts.map

package/dist/integration/ref-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-cli.d.ts","sourceRoot":"","sources":["../../src/integration/ref-cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAKlB,IAAI,EAAE,MAAM;IAJrB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EAC5B,KAAK,CAAC,EAAE,KAAK;CAMhB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAM1D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAM1D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAcvD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkBD;;GAEG;AACH,wBAAsB,MAAM,CAC1B,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CA6BvB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,OAAO,CAAC,CA4BlB"}

package/dist/integration/ref-cli.js

@@ -0,0 +1,132 @@
+import { exec } from "node:child_process";
+import { RefAddOutputSchema } from "./types.js";
+class RefCliError extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.name = "RefCliError";
+    this.cause = cause;
+  }
+  cause;
+}
+async function checkRefAvailable() {
+  return new Promise((resolve) => {
+    exec("ref --version", (error) => {
+      resolve(!error);
+    });
+  });
+}
+async function checkNpmAvailable() {
+  return new Promise((resolve) => {
+    exec("npm --version", (error) => {
+      resolve(!error);
+    });
+  });
+}
+async function installRefManager() {
+  return new Promise((resolve, reject) => {
+    exec("npm i -g @ncukondo/reference-manager", (error, stdout, stderr) => {
+      if (error) {
+        reject(new RefCliError(
+          `Failed to install reference-manager: ${stderr || error.message}`,
+          "INSTALL_FAILED",
+          error
+        ));
+      } else {
+        resolve();
+      }
+    });
+  });
+}
+function escapeShellArg(arg) {
+  return arg.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function buildLibraryOption(libraryPath) {
+  if (!libraryPath) return "";
+  return `--library "${escapeShellArg(libraryPath)}" `;
+}
+async function refAdd(id, options) {
+  const escapedId = escapeShellArg(id);
+  const libraryOpt = buildLibraryOption(options?.libraryPath);
+  const cmd = `ref ${libraryOpt}add "${escapedId}" -o json`;
+  return new Promise((resolve, reject) => {
+    exec(cmd, (error, stdout, stderr) => {
+      if (error) {
+        reject(new RefCliError(
+          `ref add failed: ${stderr || error.message}`,
+          "REF_ADD_FAILED",
+          error
+        ));
+        return;
+      }
+      try {
+        const parsed = JSON.parse(stdout);
+        const validated = RefAddOutputSchema.parse(parsed);
+        resolve(validated);
+      } catch (parseError) {
+        reject(new RefCliError(
+          `Failed to parse ref add output: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
+          "PARSE_ERROR",
+          parseError instanceof Error ? parseError : void 0
+        ));
+      }
+    });
+  });
+}
+async function refUpdate(id, field, value, options) {
+  const escapedId = escapeShellArg(id);
+  const escapedField = escapeShellArg(field);
+  const escapedValue = escapeShellArg(value);
+  const libraryOpt = buildLibraryOption(options?.libraryPath);
+  const cmd = `ref ${libraryOpt}update "${escapedId}" --set "${escapedField}=${escapedValue}"`;
+  return new Promise((resolve, reject) => {
+    exec(cmd, (error, stdout, stderr) => {
+      if (error) {
+        reject(new RefCliError(
+          `ref update failed: ${stderr || error.message}`,
+          "REF_UPDATE_FAILED",
+          error
+        ));
+      } else {
+        resolve();
+      }
+    });
+  });
+}
+async function refExport(id, options) {
+  const escapedId = escapeShellArg(id);
+  const libraryOpt = buildLibraryOption(options?.libraryPath);
+  const cmd = `ref ${libraryOpt}export "${escapedId}"`;
+  return new Promise((resolve, reject) => {
+    exec(cmd, (error, stdout, stderr) => {
+      if (error) {
+        reject(new RefCliError(
+          `ref export failed: ${stderr || error.message}`,
+          "REF_EXPORT_FAILED",
+          error
+        ));
+        return;
+      }
+      try {
+        const parsed = JSON.parse(stdout);
+        resolve(parsed);
+      } catch (parseError) {
+        reject(new RefCliError(
+          `Failed to parse ref export output: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
+          "PARSE_ERROR",
+          parseError instanceof Error ? parseError : void 0
+        ));
+      }
+    });
+  });
+}
+export {
+  RefCliError,
+  checkNpmAvailable,
+  checkRefAvailable,
+  installRefManager,
+  refAdd,
+  refExport,
+  refUpdate
+};
+//# sourceMappingURL=ref-cli.js.map

package/dist/integration/ref-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-cli.js","sources":["../../src/integration/ref-cli.ts"],"sourcesContent":["/**\n * ref CLI wrapper for reference-manager integration.\n * Provides functions to interact with the reference-manager CLI.\n */\n\nimport { exec } from 'node:child_process';\nimport { RefAddOutputSchema, type RefAddOutput } from './types.js';\n\n/**\n * Error thrown by ref CLI operations.\n */\nexport class RefCliError extends Error {\n  override cause: Error | undefined;\n\n  constructor(\n    message: string,\n    public readonly code: string,\n    cause?: Error\n  ) {\n    super(message);\n    this.name = 'RefCliError';\n    this.cause = cause;\n  }\n}\n\n/**\n * Check if the ref command is available.\n */\nexport async function checkRefAvailable(): Promise<boolean> {\n  return new Promise((resolve) => {\n    exec('ref --version', (error) => {\n      resolve(!error);\n    });\n  });\n}\n\n/**\n * Check if npm is available.\n */\nexport async function checkNpmAvailable(): Promise<boolean> {\n  return new Promise((resolve) => {\n    exec('npm --version', (error) => {\n      resolve(!error);\n    });\n  });\n}\n\n/**\n * Install reference-manager globally via npm.\n */\nexport async function installRefManager(): Promise<void> {\n  return new Promise((resolve, reject) => {\n    exec('npm i -g @ncukondo/reference-manager', (error, stdout, stderr) => {\n      if (error) {\n        reject(new RefCliError(\n          `Failed to install reference-manager: ${stderr || error.message}`,\n          'INSTALL_FAILED',\n          error\n        ));\n      } else {\n        resolve();\n      }\n    });\n  });\n}\n\n/**\n * Options for ref CLI commands.\n */\nexport interface RefCliOptions {\n  /** Path to the library file (uses --library option) */\n  libraryPath?: string;\n}\n\n/**\n * Escape a string for use in shell command.\n */\nfunction escapeShellArg(arg: string): string {\n  // Escape double quotes and backslashes\n  return arg.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"');\n}\n\n/**\n * Build library option string for ref commands.\n */\nfunction buildLibraryOption(libraryPath?: string): string {\n  if (!libraryPath) return '';\n  return `--library \"${escapeShellArg(libraryPath)}\" `;\n}\n\n/**\n * Execute ref add command and return parsed output.\n */\nexport async function refAdd(\n  id: string,\n  options?: RefCliOptions\n): Promise<RefAddOutput> {\n  const escapedId = escapeShellArg(id);\n  const libraryOpt = buildLibraryOption(options?.libraryPath);\n  const cmd = `ref ${libraryOpt}add \"${escapedId}\" -o json`;\n\n  return new Promise((resolve, reject) => {\n    exec(cmd, (error, stdout, stderr) => {\n      if (error) {\n        reject(new RefCliError(\n          `ref add failed: ${stderr || error.message}`,\n          'REF_ADD_FAILED',\n          error\n        ));\n        return;\n      }\n\n      try {\n        const parsed = JSON.parse(stdout);\n        const validated = RefAddOutputSchema.parse(parsed);\n        resolve(validated);\n      } catch (parseError) {\n        reject(new RefCliError(\n          `Failed to parse ref add output: ${parseError instanceof Error ? parseError.message : 'Unknown error'}`,\n          'PARSE_ERROR',\n          parseError instanceof Error ? parseError : undefined\n        ));\n      }\n    });\n  });\n}\n\n/**\n * Execute ref update command to update a field.\n */\nexport async function refUpdate(\n  id: string,\n  field: string,\n  value: string,\n  options?: RefCliOptions\n): Promise<void> {\n  const escapedId = escapeShellArg(id);\n  const escapedField = escapeShellArg(field);\n  const escapedValue = escapeShellArg(value);\n  const libraryOpt = buildLibraryOption(options?.libraryPath);\n  const cmd = `ref ${libraryOpt}update \"${escapedId}\" --set \"${escapedField}=${escapedValue}\"`;\n\n  return new Promise((resolve, reject) => {\n    exec(cmd, (error, stdout, stderr) => {\n      if (error) {\n        reject(new RefCliError(\n          `ref update failed: ${stderr || error.message}`,\n          'REF_UPDATE_FAILED',\n          error\n        ));\n      } else {\n        resolve();\n      }\n    });\n  });\n}\n\n/**\n * Execute ref export command and return the entry data.\n */\nexport async function refExport(\n  id: string,\n  options?: RefCliOptions\n): Promise<unknown> {\n  const escapedId = escapeShellArg(id);\n  const libraryOpt = buildLibraryOption(options?.libraryPath);\n  const cmd = `ref ${libraryOpt}export \"${escapedId}\"`;\n\n  return new Promise((resolve, reject) => {\n    exec(cmd, (error, stdout, stderr) => {\n      if (error) {\n        reject(new RefCliError(\n          `ref export failed: ${stderr || error.message}`,\n          'REF_EXPORT_FAILED',\n          error\n        ));\n        return;\n      }\n\n      try {\n        const parsed = JSON.parse(stdout);\n        resolve(parsed);\n      } catch (parseError) {\n        reject(new RefCliError(\n          `Failed to parse ref export output: ${parseError instanceof Error ? parseError.message : 'Unknown error'}`,\n          'PARSE_ERROR',\n          parseError instanceof Error ? parseError : undefined\n        ));\n      }\n    });\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/integration/register.d.ts

@@ -0,0 +1,27 @@
+import { Article } from '../providers/base/types.js';
+import { RegistrationRecord } from './types.js';
+/**
+ * Save registration record to session directory.
+ */
+export declare function saveRegistrationRecord(sessionDir: string, record: RegistrationRecord): Promise<void>;
+/**
+ * Load registration record from session directory.
+ * Returns null if file does not exist.
+ * Throws if file exists but is invalid.
+ */
+export declare function loadRegistrationRecord(sessionDir: string): Promise<RegistrationRecord | null>;
+/**
+ * Options for registerArticles function.
+ */
+export interface RegisterOptions {
+    sessionId: string;
+    sessionDir: string;
+    withAbstracts?: boolean;
+    onProgress?: (current: number, total: number) => void;
+}
+/**
+ * Register articles with reference-manager.
+ * Processes each article and aggregates results.
+ */
+export declare function registerArticles(articles: Article[], options: RegisterOptions): Promise<RegistrationRecord>;
+//# sourceMappingURL=register.d.ts.map

package/dist/integration/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/integration/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAK/E;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAcpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAsCD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA4F7B"}