@opendataloader/pdf 1.2.0 → 1.4.1

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command, CommanderError } from 'commander';\nimport { convert, ConvertOptions } from './index.js';\n\ninterface CliOptions {\n  outputDir?: string;\n  password?: string;\n  format?: string[];\n  quiet?: boolean;\n  contentSafetyOff?: string[];\n  keepLineBreaks?: boolean;\n  replaceInvalidChars?: string;\n  useStructTree?: boolean;\n}\n\nconst VALID_FORMATS = new Set([\n  'json',\n  'text',\n  'html',\n  'pdf',\n  'markdown',\n  'markdown-with-html',\n  'markdown-with-images',\n]);\n\nconst VALID_CONTENT_SAFETY_MODES = new Set([\n  'all',\n  'hidden-text',\n  'off-page',\n  'tiny',\n  'hidden-ocg',\n]);\n\nfunction createProgram(): Command {\n  const program = new Command();\n\n  program\n    .name('opendataloader-pdf')\n    .usage('[options] <input...>')\n    .description('Convert PDFs using the OpenDataLoader CLI.')\n    .showHelpAfterError(\"Use '--help' to see available options.\")\n    .showSuggestionAfterError(false)\n    .argument('<input...>', 'Input files or directories to convert')\n    .option('-o, --output-dir <path>', 'Directory where outputs are written')\n    .option('-p, --password <password>', 'Password for encrypted PDFs')\n    .option(\n      '-f, --format <value...>',\n      'Output formats to generate (json, text, html, pdf, markdown, markdown-with-html, markdown-with-images)',\n    )\n    .option('-q, --quiet', 'Suppress CLI logging output')\n    .option('--content-safety-off <mode...>', 'Disable one or more content safety filters')\n    .option('--keep-line-breaks', 'Preserve line breaks in text output')\n    .option('--replace-invalid-chars <c>', 'Replacement character for invalid characters')\n    .option('--use-struct-tree', 'Enable processing structure tree (disabled by default)');\n\n  program.configureOutput({\n    writeErr: (str) => {\n      console.error(str.trimEnd());\n    },\n    outputError: (str, write) => {\n      write(str);\n    },\n  });\n\n  return program;\n}\n\nfunction buildConvertOptions(options: CliOptions): ConvertOptions {\n  const convertOptions: ConvertOptions = {};\n\n  if (options.outputDir) {\n    convertOptions.outputDir = options.outputDir;\n  }\n  if (options.password) {\n    convertOptions.password = options.password;\n  }\n  if (options.format && options.format.length > 0) {\n    convertOptions.format = options.format;\n  }\n  if (options.quiet) {\n    convertOptions.quiet = true;\n  }\n  if (options.contentSafetyOff && options.contentSafetyOff.length > 0) {\n    convertOptions.contentSafetyOff = options.contentSafetyOff;\n  }\n  if (options.keepLineBreaks) {\n    convertOptions.keepLineBreaks = true;\n  }\n  if (options.replaceInvalidChars) {\n    convertOptions.replaceInvalidChars = options.replaceInvalidChars;\n  }\n  if (options.useStructTree) {\n    convertOptions.useStructTree = true;\n  }\n\n  return convertOptions;\n}\n\nasync function main(): Promise<number> {\n  const program = createProgram();\n\n  program.exitOverride();\n\n  try {\n    program.parse(process.argv);\n  } catch (err) {\n    if (err instanceof CommanderError) {\n      if (err.code === 'commander.helpDisplayed') {\n        return 0;\n      }\n      return err.exitCode ?? 1;\n    }\n\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(message);\n    console.error(\"Use '--help' to see available options.\");\n    return 1;\n  }\n\n  const cliOptions = program.opts<CliOptions>();\n  const inputPaths = program.args;\n\n  if (cliOptions.format) {\n    for (const value of cliOptions.format) {\n      if (!VALID_FORMATS.has(value)) {\n        console.error(`Invalid format '${value}'. See '--help' for allowed values.`);\n        console.error(\"Use '--help' to see available options.\");\n        return 1;\n      }\n    }\n  }\n\n  if (cliOptions.contentSafetyOff) {\n    for (const value of cliOptions.contentSafetyOff) {\n      if (!VALID_CONTENT_SAFETY_MODES.has(value)) {\n        console.error(`Invalid content safety mode '${value}'. See '--help' for allowed values.`);\n        console.error(\"Use '--help' to see available options.\");\n        return 1;\n      }\n    }\n  }\n\n  const convertOptions = buildConvertOptions(cliOptions);\n\n  try {\n    const output = await convert(inputPaths, convertOptions);\n    if (output && !convertOptions.quiet) {\n      process.stdout.write(output);\n      if (!output.endsWith('\\n')) {\n        process.stdout.write('\\n');\n      }\n    }\n    return 0;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(message);\n    return 1;\n  }\n}\n\nmain().then((code) => {\n  if (code !== 0) {\n    process.exit(code);\n  }\n});\n","import { spawn } from 'child_process';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { fileURLToPath } from 'url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nconst JAR_NAME = 'opendataloader-pdf-cli.jar';\n\ninterface JarExecutionOptions {\n  debug?: boolean;\n  streamOutput?: boolean;\n}\n\nfunction executeJar(args: string[], executionOptions: JarExecutionOptions = {}): Promise<string> {\n  const { debug = false, streamOutput = false } = executionOptions;\n\n  return new Promise((resolve, reject) => {\n    const jarPath = path.join(__dirname, '..', 'lib', JAR_NAME);\n\n    if (!fs.existsSync(jarPath)) {\n      return reject(\n        new Error(`JAR file not found at ${jarPath}. Please run the build script first.`),\n      );\n    }\n\n    const command = 'java';\n    const commandArgs = ['-jar', jarPath, ...args];\n\n    const javaProcess = spawn(command, commandArgs);\n\n    let stdout = '';\n    let stderr = '';\n\n    javaProcess.stdout.on('data', (data) => {\n      const chunk = data.toString();\n      if (streamOutput) {\n        process.stdout.write(chunk);\n      }\n      stdout += chunk;\n    });\n\n    javaProcess.stderr.on('data', (data) => {\n      const chunk = data.toString();\n      if (streamOutput) {\n        process.stderr.write(chunk);\n      }\n      stderr += chunk;\n    });\n\n    javaProcess.on('close', (code) => {\n      if (code === 0) {\n        resolve(stdout);\n      } else {\n        const errorOutput = stderr || stdout;\n        const error = new Error(\n          `The opendataloader-pdf CLI exited with code ${code}.\\n\\n${errorOutput}`,\n        );\n        reject(error);\n      }\n    });\n\n    javaProcess.on('error', (err: Error) => {\n      if (err.message.includes('ENOENT')) {\n        reject(\n          new Error(\n            \"'java' command not found. Please ensure Java is installed and in your system's PATH.\",\n          ),\n        );\n      } else {\n        reject(err);\n      }\n    });\n  });\n}\n\nexport interface RunOptions {\n  outputFolder?: string;\n  password?: string;\n  replaceInvalidChars?: string;\n  generateMarkdown?: boolean;\n  generateHtml?: boolean;\n  generateAnnotatedPdf?: boolean;\n  keepLineBreaks?: boolean;\n  contentSafetyOff?: string;\n  htmlInMarkdown?: boolean;\n  addImageToMarkdown?: boolean;\n  noJson?: boolean;\n  debug?: boolean;\n  useStructTree?: boolean;\n}\n\nexport function run(inputPath: string, options: RunOptions = {}): Promise<string> {\n  return new Promise((resolve, reject) => {\n    if (!fs.existsSync(inputPath)) {\n      return reject(new Error(`Input file or folder not found: ${inputPath}`));\n    }\n\n    const args: string[] = [];\n    if (options.outputFolder) {\n      args.push('--output-dir', options.outputFolder);\n    }\n    if (options.password) {\n      args.push('--password', options.password);\n    }\n    if (options.replaceInvalidChars) {\n      args.push('--replace-invalid-chars', options.replaceInvalidChars);\n    }\n    if (options.generateMarkdown) {\n      args.push('--markdown');\n    }\n    if (options.generateHtml) {\n      args.push('--html');\n    }\n    if (options.generateAnnotatedPdf) {\n      args.push('--pdf');\n    }\n    if (options.keepLineBreaks) {\n      args.push('--keep-line-breaks');\n    }\n    if (options.contentSafetyOff) {\n      args.push('--content-safety-off', options.contentSafetyOff);\n    }\n    if (options.htmlInMarkdown) {\n      args.push('--markdown-with-html');\n    }\n    if (options.addImageToMarkdown) {\n      args.push('--markdown-with-images');\n    }\n    if (options.noJson) {\n      args.push('--no-json');\n    }\n    if (options.useStructTree) {\n      args.push('--use-struct-tree')\n    }\n\n    args.push(inputPath);\n    executeJar(args, {\n      debug: options.debug,\n      streamOutput: Boolean(options.debug),\n    })\n      .then(resolve)\n      .catch(reject);\n  });\n}\n\nexport interface ConvertOptions {\n  outputDir?: string;\n  password?: string;\n  format?: string[];\n  quiet?: boolean;\n  contentSafetyOff?: string[];\n  keepLineBreaks?: boolean;\n  replaceInvalidChars?: string;\n  useStructTree?: boolean;\n}\n\nexport function convert(inputPaths: string[], options: ConvertOptions = {}): Promise<string> {\n  if (inputPaths.length === 0) {\n    return Promise.reject(new Error('At least one input path must be provided.'));\n  }\n\n  for (const input of inputPaths) {\n    if (!fs.existsSync(input)) {\n      return Promise.reject(new Error(`Input file or folder not found: ${input}`));\n    }\n  }\n\n  const args: string[] = [...inputPaths];\n  if (options.outputDir) {\n    args.push('--output-dir', options.outputDir);\n  }\n  if (options.password) {\n    args.push('--password', options.password);\n  }\n  if (options.format && options.format.length > 0) {\n    args.push('--format', ...options.format);\n  }\n  if (options.quiet) {\n    args.push('--quiet');\n  }\n  if (options.contentSafetyOff && options.contentSafetyOff.length > 0) {\n    args.push('--content-safety-off', ...options.contentSafetyOff);\n  }\n  if (options.keepLineBreaks) {\n    args.push('--keep-line-breaks');\n  }\n  if (options.replaceInvalidChars) {\n    args.push('--replace-invalid-chars', options.replaceInvalidChars);\n  }\n  if (options.useStructTree) {\n    args.push('--use-struct-tree')\n  }\n\n  return executeJar(args, {\n    streamOutput: !options.quiet,\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli.ts","../src/index.ts","../src/convert-options.generated.ts","../src/cli-options.generated.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command, CommanderError } from 'commander';\nimport { convert } from './index.js';\nimport { CliOptions, buildConvertOptions } from './convert-options.generated.js';\nimport { registerCliOptions } from './cli-options.generated.js';\n\nfunction createProgram(): Command {\n  const program = new Command();\n\n  program\n    .name('opendataloader-pdf')\n    .usage('[options] <input...>')\n    .description('Convert PDFs using the OpenDataLoader CLI.')\n    .showHelpAfterError(\"Use '--help' to see available options.\")\n    .showSuggestionAfterError(false)\n    .argument('<input...>', 'Input files or directories to convert');\n\n  // Register CLI options from auto-generated file\n  registerCliOptions(program);\n\n  program.configureOutput({\n    writeErr: (str) => {\n      console.error(str.trimEnd());\n    },\n    outputError: (str, write) => {\n      write(str);\n    },\n  });\n\n  return program;\n}\n\nasync function main(): Promise<number> {\n  const program = createProgram();\n\n  program.exitOverride();\n\n  try {\n    program.parse(process.argv);\n  } catch (err) {\n    if (err instanceof CommanderError) {\n      if (err.code === 'commander.helpDisplayed') {\n        return 0;\n      }\n      return err.exitCode ?? 1;\n    }\n\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(message);\n    console.error(\"Use '--help' to see available options.\");\n    return 1;\n  }\n\n  const cliOptions = program.opts<CliOptions>();\n  const inputPaths = program.args;\n  const convertOptions = buildConvertOptions(cliOptions);\n\n  try {\n    const output = await convert(inputPaths, convertOptions);\n    if (output && !convertOptions.quiet) {\n      process.stdout.write(output);\n      if (!output.endsWith('\\n')) {\n        process.stdout.write('\\n');\n      }\n    }\n    return 0;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(message);\n    return 1;\n  }\n}\n\nmain().then((code) => {\n  if (code !== 0) {\n    process.exit(code);\n  }\n});\n","import { spawn } from 'child_process';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { fileURLToPath } from 'url';\n\n// Re-export types and utilities from auto-generated file\nexport type { ConvertOptions } from './convert-options.generated.js';\nexport { buildArgs } from './convert-options.generated.js';\nimport type { ConvertOptions } from './convert-options.generated.js';\nimport { buildArgs } from './convert-options.generated.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nconst JAR_NAME = 'opendataloader-pdf-cli.jar';\n\ninterface JarExecutionOptions {\n  streamOutput?: boolean;\n}\n\nfunction executeJar(args: string[], executionOptions: JarExecutionOptions = {}): Promise<string> {\n  const { streamOutput = false } = executionOptions;\n\n  return new Promise((resolve, reject) => {\n    const jarPath = path.join(__dirname, '..', 'lib', JAR_NAME);\n\n    if (!fs.existsSync(jarPath)) {\n      return reject(\n        new Error(`JAR file not found at ${jarPath}. Please run the build script first.`),\n      );\n    }\n\n    const command = 'java';\n    const commandArgs = ['-jar', jarPath, ...args];\n\n    const javaProcess = spawn(command, commandArgs);\n\n    let stdout = '';\n    let stderr = '';\n\n    javaProcess.stdout.on('data', (data) => {\n      const chunk = data.toString();\n      if (streamOutput) {\n        process.stdout.write(chunk);\n      }\n      stdout += chunk;\n    });\n\n    javaProcess.stderr.on('data', (data) => {\n      const chunk = data.toString();\n      if (streamOutput) {\n        process.stderr.write(chunk);\n      }\n      stderr += chunk;\n    });\n\n    javaProcess.on('close', (code) => {\n      if (code === 0) {\n        resolve(stdout);\n      } else {\n        const errorOutput = stderr || stdout;\n        const error = new Error(\n          `The opendataloader-pdf CLI exited with code ${code}.\\n\\n${errorOutput}`,\n        );\n        reject(error);\n      }\n    });\n\n    javaProcess.on('error', (err: Error) => {\n      if (err.message.includes('ENOENT')) {\n        reject(\n          new Error(\n            \"'java' command not found. Please ensure Java is installed and in your system's PATH.\",\n          ),\n        );\n      } else {\n        reject(err);\n      }\n    });\n  });\n}\n\nexport function convert(\n  inputPaths: string | string[],\n  options: ConvertOptions = {},\n): Promise<string> {\n  const inputList = Array.isArray(inputPaths) ? inputPaths : [inputPaths];\n  if (inputList.length === 0) {\n    return Promise.reject(new Error('At least one input path must be provided.'));\n  }\n\n  for (const input of inputList) {\n    if (!fs.existsSync(input)) {\n      return Promise.reject(new Error(`Input file or folder not found: ${input}`));\n    }\n  }\n\n  const args: string[] = [...inputList, ...buildArgs(options)];\n\n  return executeJar(args, {\n    streamOutput: !options.quiet,\n  });\n}\n\n/**\n * @deprecated Use `convert()` and `ConvertOptions` instead. This function will be removed in a future version.\n */\nexport interface RunOptions {\n  outputFolder?: string;\n  password?: string;\n  replaceInvalidChars?: string;\n  generateMarkdown?: boolean;\n  generateHtml?: boolean;\n  generateAnnotatedPdf?: boolean;\n  keepLineBreaks?: boolean;\n  contentSafetyOff?: string;\n  htmlInMarkdown?: boolean;\n  addImageToMarkdown?: boolean;\n  noJson?: boolean;\n  debug?: boolean;\n  useStructTree?: boolean;\n}\n\n/**\n * @deprecated Use `convert()` instead. This function will be removed in a future version.\n */\nexport function run(inputPath: string, options: RunOptions = {}): Promise<string> {\n  console.warn(\n    'Warning: run() is deprecated and will be removed in a future version. Use convert() instead.',\n  );\n\n  // Build format array based on legacy boolean options\n  const formats: string[] = [];\n  if (!options.noJson) {\n    formats.push('json');\n  }\n  if (options.generateMarkdown) {\n    if (options.addImageToMarkdown) {\n      formats.push('markdown-with-images');\n    } else if (options.htmlInMarkdown) {\n      formats.push('markdown-with-html');\n    } else {\n      formats.push('markdown');\n    }\n  }\n  if (options.generateHtml) {\n    formats.push('html');\n  }\n  if (options.generateAnnotatedPdf) {\n    formats.push('pdf');\n  }\n\n  return convert(inputPath, {\n    outputDir: options.outputFolder,\n    password: options.password,\n    replaceInvalidChars: options.replaceInvalidChars,\n    keepLineBreaks: options.keepLineBreaks,\n    contentSafetyOff: options.contentSafetyOff,\n    useStructTree: options.useStructTree,\n    format: formats.length > 0 ? formats : undefined,\n    quiet: !options.debug,\n  });\n}\n","// AUTO-GENERATED FROM options.json - DO NOT EDIT DIRECTLY\n// Run `npm run generate-options` to regenerate\n\n/**\n * Options for the convert function.\n */\nexport interface ConvertOptions {\n  /** Directory where output files are written. Default: input file directory */\n  outputDir?: string;\n  /** Password for encrypted PDF files */\n  password?: string;\n  /** Output formats (comma-separated). Values: json, text, html, pdf, markdown, markdown-with-html, markdown-with-images. Default: json */\n  format?: string | string[];\n  /** Suppress console logging output */\n  quiet?: boolean;\n  /** Disable content safety filters. Values: all, hidden-text, off-page, tiny, hidden-ocg */\n  contentSafetyOff?: string | string[];\n  /** Preserve original line breaks in extracted text */\n  keepLineBreaks?: boolean;\n  /** Replacement character for invalid/unrecognized characters. Default: space */\n  replaceInvalidChars?: string;\n  /** Use PDF structure tree (tagged PDF) for reading order and semantic structure */\n  useStructTree?: boolean;\n  /** Table detection method. Values: cluster */\n  tableMethod?: string;\n  /** Reading order algorithm. Values: none, xycut. Default: none */\n  readingOrder?: string;\n  /** Separator between pages in Markdown output. Use %page-number% for page numbers. Default: none */\n  markdownPageSeparator?: string;\n  /** Separator between pages in text output. Use %page-number% for page numbers. Default: none */\n  textPageSeparator?: string;\n  /** Separator between pages in HTML output. Use %page-number% for page numbers. Default: none */\n  htmlPageSeparator?: string;\n  /** Embed images as Base64 data URIs instead of file path references */\n  embedImages?: boolean;\n  /** Output format for extracted images. Values: png, jpeg. Default: png */\n  imageFormat?: string;\n}\n\n/**\n * Options as parsed from CLI (all values are strings from commander).\n */\nexport interface CliOptions {\n  outputDir?: string;\n  password?: string;\n  format?: string;\n  quiet?: boolean;\n  contentSafetyOff?: string;\n  keepLineBreaks?: boolean;\n  replaceInvalidChars?: string;\n  useStructTree?: boolean;\n  tableMethod?: string;\n  readingOrder?: string;\n  markdownPageSeparator?: string;\n  textPageSeparator?: string;\n  htmlPageSeparator?: string;\n  embedImages?: boolean;\n  imageFormat?: string;\n}\n\n/**\n * Convert CLI options to ConvertOptions.\n */\nexport function buildConvertOptions(cliOptions: CliOptions): ConvertOptions {\n  const convertOptions: ConvertOptions = {};\n\n  if (cliOptions.outputDir) {\n    convertOptions.outputDir = cliOptions.outputDir;\n  }\n  if (cliOptions.password) {\n    convertOptions.password = cliOptions.password;\n  }\n  if (cliOptions.format) {\n    convertOptions.format = cliOptions.format;\n  }\n  if (cliOptions.quiet) {\n    convertOptions.quiet = true;\n  }\n  if (cliOptions.contentSafetyOff) {\n    convertOptions.contentSafetyOff = cliOptions.contentSafetyOff;\n  }\n  if (cliOptions.keepLineBreaks) {\n    convertOptions.keepLineBreaks = true;\n  }\n  if (cliOptions.replaceInvalidChars) {\n    convertOptions.replaceInvalidChars = cliOptions.replaceInvalidChars;\n  }\n  if (cliOptions.useStructTree) {\n    convertOptions.useStructTree = true;\n  }\n  if (cliOptions.tableMethod) {\n    convertOptions.tableMethod = cliOptions.tableMethod;\n  }\n  if (cliOptions.readingOrder) {\n    convertOptions.readingOrder = cliOptions.readingOrder;\n  }\n  if (cliOptions.markdownPageSeparator) {\n    convertOptions.markdownPageSeparator = cliOptions.markdownPageSeparator;\n  }\n  if (cliOptions.textPageSeparator) {\n    convertOptions.textPageSeparator = cliOptions.textPageSeparator;\n  }\n  if (cliOptions.htmlPageSeparator) {\n    convertOptions.htmlPageSeparator = cliOptions.htmlPageSeparator;\n  }\n  if (cliOptions.embedImages) {\n    convertOptions.embedImages = true;\n  }\n  if (cliOptions.imageFormat) {\n    convertOptions.imageFormat = cliOptions.imageFormat;\n  }\n\n  return convertOptions;\n}\n\n/**\n * Build CLI arguments array from ConvertOptions.\n */\nexport function buildArgs(options: ConvertOptions): string[] {\n  const args: string[] = [];\n\n  if (options.outputDir) {\n    args.push('--output-dir', options.outputDir);\n  }\n  if (options.password) {\n    args.push('--password', options.password);\n  }\n  if (options.format) {\n    if (Array.isArray(options.format)) {\n      if (options.format.length > 0) {\n        args.push('--format', options.format.join(','));\n      }\n    } else {\n      args.push('--format', options.format);\n    }\n  }\n  if (options.quiet) {\n    args.push('--quiet');\n  }\n  if (options.contentSafetyOff) {\n    if (Array.isArray(options.contentSafetyOff)) {\n      if (options.contentSafetyOff.length > 0) {\n        args.push('--content-safety-off', options.contentSafetyOff.join(','));\n      }\n    } else {\n      args.push('--content-safety-off', options.contentSafetyOff);\n    }\n  }\n  if (options.keepLineBreaks) {\n    args.push('--keep-line-breaks');\n  }\n  if (options.replaceInvalidChars) {\n    args.push('--replace-invalid-chars', options.replaceInvalidChars);\n  }\n  if (options.useStructTree) {\n    args.push('--use-struct-tree');\n  }\n  if (options.tableMethod) {\n    args.push('--table-method', options.tableMethod);\n  }\n  if (options.readingOrder) {\n    args.push('--reading-order', options.readingOrder);\n  }\n  if (options.markdownPageSeparator) {\n    args.push('--markdown-page-separator', options.markdownPageSeparator);\n  }\n  if (options.textPageSeparator) {\n    args.push('--text-page-separator', options.textPageSeparator);\n  }\n  if (options.htmlPageSeparator) {\n    args.push('--html-page-separator', options.htmlPageSeparator);\n  }\n  if (options.embedImages) {\n    args.push('--embed-images');\n  }\n  if (options.imageFormat) {\n    args.push('--image-format', options.imageFormat);\n  }\n\n  return args;\n}\n","// AUTO-GENERATED FROM options.json - DO NOT EDIT DIRECTLY\n// Run `npm run generate-options` to regenerate\n\nimport { Command } from 'commander';\n\n/**\n * Register all CLI options on the given Commander program.\n */\nexport function registerCliOptions(program: Command): void {\n  program.option('-o, --output-dir <value>', 'Directory where output files are written. Default: input file directory');\n  program.option('-p, --password <value>', 'Password for encrypted PDF files');\n  program.option('-f, --format <value>', 'Output formats (comma-separated). Values: json, text, html, pdf, markdown, markdown-with-html, markdown-with-images. Default: json');\n  program.option('-q, --quiet', 'Suppress console logging output');\n  program.option('--content-safety-off <value>', 'Disable content safety filters. Values: all, hidden-text, off-page, tiny, hidden-ocg');\n  program.option('--keep-line-breaks', 'Preserve original line breaks in extracted text');\n  program.option('--replace-invalid-chars <value>', 'Replacement character for invalid/unrecognized characters. Default: space');\n  program.option('--use-struct-tree', 'Use PDF structure tree (tagged PDF) for reading order and semantic structure');\n  program.option('--table-method <value>', 'Table detection method. Values: cluster');\n  program.option('--reading-order <value>', 'Reading order algorithm. Values: none, xycut. Default: none');\n  program.option('--markdown-page-separator <value>', 'Separator between pages in Markdown output. Use %page-number% for page numbers. Default: none');\n  program.option('--text-page-separator <value>', 'Separator between pages in text output. Use %page-number% for page numbers. Default: none');\n  program.option('--html-page-separator <value>', 'Separator between pages in HTML output. Use %page-number% for page numbers. Default: none');\n  program.option('--embed-images', 'Embed images as Base64 data URIs instead of file path references');\n  program.option('--image-format <value>', 'Output format for extracted images. Values: png, jpeg. Default: png');\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  buildArgs: () => buildArgs,
   convert: () => convert,
   run: () => run
 });
@@ -38,12 +39,77 @@ var import_child_process = require("child_process");
 var path = __toESM(require("path"), 1);
 var fs = __toESM(require("fs"), 1);
 var import_url = require("url");
+
+// src/convert-options.generated.ts
+function buildArgs(options) {
+  const args = [];
+  if (options.outputDir) {
+    args.push("--output-dir", options.outputDir);
+  }
+  if (options.password) {
+    args.push("--password", options.password);
+  }
+  if (options.format) {
+    if (Array.isArray(options.format)) {
+      if (options.format.length > 0) {
+        args.push("--format", options.format.join(","));
+      }
+    } else {
+      args.push("--format", options.format);
+    }
+  }
+  if (options.quiet) {
+    args.push("--quiet");
+  }
+  if (options.contentSafetyOff) {
+    if (Array.isArray(options.contentSafetyOff)) {
+      if (options.contentSafetyOff.length > 0) {
+        args.push("--content-safety-off", options.contentSafetyOff.join(","));
+      }
+    } else {
+      args.push("--content-safety-off", options.contentSafetyOff);
+    }
+  }
+  if (options.keepLineBreaks) {
+    args.push("--keep-line-breaks");
+  }
+  if (options.replaceInvalidChars) {
+    args.push("--replace-invalid-chars", options.replaceInvalidChars);
+  }
+  if (options.useStructTree) {
+    args.push("--use-struct-tree");
+  }
+  if (options.tableMethod) {
+    args.push("--table-method", options.tableMethod);
+  }
+  if (options.readingOrder) {
+    args.push("--reading-order", options.readingOrder);
+  }
+  if (options.markdownPageSeparator) {
+    args.push("--markdown-page-separator", options.markdownPageSeparator);
+  }
+  if (options.textPageSeparator) {
+    args.push("--text-page-separator", options.textPageSeparator);
+  }
+  if (options.htmlPageSeparator) {
+    args.push("--html-page-separator", options.htmlPageSeparator);
+  }
+  if (options.embedImages) {
+    args.push("--embed-images");
+  }
+  if (options.imageFormat) {
+    args.push("--image-format", options.imageFormat);
+  }
+  return args;
+}
+
+// src/index.ts
 var import_meta = {};
 var __filename = (0, import_url.fileURLToPath)(import_meta.url);
 var __dirname = path.dirname(__filename);
 var JAR_NAME = "opendataloader-pdf-cli.jar";
 function executeJar(args, executionOptions = {}) {
-  const { debug = false, streamOutput = false } = executionOptions;
+  const { streamOutput = false } = executionOptions;
   return new Promise((resolve, reject) => {
     const jarPath = path.join(__dirname, "..", "lib", JAR_NAME);
     if (!fs.existsSync(jarPath)) {
@@ -96,95 +162,58 @@ ${errorOutput}`
     });
   });
 }
-function run(inputPath, options = {}) {
-  return new Promise((resolve, reject) => {
-    if (!fs.existsSync(inputPath)) {
-      return reject(new Error(`Input file or folder not found: ${inputPath}`));
-    }
-    const args = [];
-    if (options.outputFolder) {
-      args.push("--output-dir", options.outputFolder);
-    }
-    if (options.password) {
-      args.push("--password", options.password);
-    }
-    if (options.replaceInvalidChars) {
-      args.push("--replace-invalid-chars", options.replaceInvalidChars);
-    }
-    if (options.generateMarkdown) {
-      args.push("--markdown");
-    }
-    if (options.generateHtml) {
-      args.push("--html");
-    }
-    if (options.generateAnnotatedPdf) {
-      args.push("--pdf");
-    }
-    if (options.keepLineBreaks) {
-      args.push("--keep-line-breaks");
-    }
-    if (options.contentSafetyOff) {
-      args.push("--content-safety-off", options.contentSafetyOff);
-    }
-    if (options.htmlInMarkdown) {
-      args.push("--markdown-with-html");
-    }
-    if (options.addImageToMarkdown) {
-      args.push("--markdown-with-images");
-    }
-    if (options.noJson) {
-      args.push("--no-json");
-    }
-    if (options.useStructTree) {
-      args.push("--use-struct-tree");
-    }
-    args.push(inputPath);
-    executeJar(args, {
-      debug: options.debug,
-      streamOutput: Boolean(options.debug)
-    }).then(resolve).catch(reject);
-  });
-}
 function convert(inputPaths, options = {}) {
-  if (inputPaths.length === 0) {
+  const inputList = Array.isArray(inputPaths) ? inputPaths : [inputPaths];
+  if (inputList.length === 0) {
     return Promise.reject(new Error("At least one input path must be provided."));
   }
-  for (const input of inputPaths) {
+  for (const input of inputList) {
     if (!fs.existsSync(input)) {
       return Promise.reject(new Error(`Input file or folder not found: ${input}`));
     }
   }
-  const args = [...inputPaths];
-  if (options.outputDir) {
-    args.push("--output-dir", options.outputDir);
-  }
-  if (options.password) {
-    args.push("--password", options.password);
-  }
-  if (options.format && options.format.length > 0) {
-    args.push("--format", ...options.format);
-  }
-  if (options.quiet) {
-    args.push("--quiet");
-  }
-  if (options.contentSafetyOff && options.contentSafetyOff.length > 0) {
-    args.push("--content-safety-off", ...options.contentSafetyOff);
+  const args = [...inputList, ...buildArgs(options)];
+  return executeJar(args, {
+    streamOutput: !options.quiet
+  });
+}
+function run(inputPath, options = {}) {
+  console.warn(
+    "Warning: run() is deprecated and will be removed in a future version. Use convert() instead."
+  );
+  const formats = [];
+  if (!options.noJson) {
+    formats.push("json");
   }
-  if (options.keepLineBreaks) {
-    args.push("--keep-line-breaks");
+  if (options.generateMarkdown) {
+    if (options.addImageToMarkdown) {
+      formats.push("markdown-with-images");
+    } else if (options.htmlInMarkdown) {
+      formats.push("markdown-with-html");
+    } else {
+      formats.push("markdown");
+    }
   }
-  if (options.replaceInvalidChars) {
-    args.push("--replace-invalid-chars", options.replaceInvalidChars);
+  if (options.generateHtml) {
+    formats.push("html");
   }
-  if (options.useStructTree) {
-    args.push("--use-struct-tree");
+  if (options.generateAnnotatedPdf) {
+    formats.push("pdf");
   }
-  return executeJar(args, {
-    streamOutput: !options.quiet
+  return convert(inputPath, {
+    outputDir: options.outputFolder,
+    password: options.password,
+    replaceInvalidChars: options.replaceInvalidChars,
+    keepLineBreaks: options.keepLineBreaks,
+    contentSafetyOff: options.contentSafetyOff,
+    useStructTree: options.useStructTree,
+    format: formats.length > 0 ? formats : void 0,
+    quiet: !options.debug
   });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  buildArgs,
   convert,
   run
 });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { spawn } from 'child_process';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { fileURLToPath } from 'url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nconst JAR_NAME = 'opendataloader-pdf-cli.jar';\n\ninterface JarExecutionOptions {\n  debug?: boolean;\n  streamOutput?: boolean;\n}\n\nfunction executeJar(args: string[], executionOptions: JarExecutionOptions = {}): Promise<string> {\n  const { debug = false, streamOutput = false } = executionOptions;\n\n  return new Promise((resolve, reject) => {\n    const jarPath = path.join(__dirname, '..', 'lib', JAR_NAME);\n\n    if (!fs.existsSync(jarPath)) {\n      return reject(\n        new Error(`JAR file not found at ${jarPath}. Please run the build script first.`),\n      );\n    }\n\n    const command = 'java';\n    const commandArgs = ['-jar', jarPath, ...args];\n\n    const javaProcess = spawn(command, commandArgs);\n\n    let stdout = '';\n    let stderr = '';\n\n    javaProcess.stdout.on('data', (data) => {\n      const chunk = data.toString();\n      if (streamOutput) {\n        process.stdout.write(chunk);\n      }\n      stdout += chunk;\n    });\n\n    javaProcess.stderr.on('data', (data) => {\n      const chunk = data.toString();\n      if (streamOutput) {\n        process.stderr.write(chunk);\n      }\n      stderr += chunk;\n    });\n\n    javaProcess.on('close', (code) => {\n      if (code === 0) {\n        resolve(stdout);\n      } else {\n        const errorOutput = stderr || stdout;\n        const error = new Error(\n          `The opendataloader-pdf CLI exited with code ${code}.\\n\\n${errorOutput}`,\n        );\n        reject(error);\n      }\n    });\n\n    javaProcess.on('error', (err: Error) => {\n      if (err.message.includes('ENOENT')) {\n        reject(\n          new Error(\n            \"'java' command not found. Please ensure Java is installed and in your system's PATH.\",\n          ),\n        );\n      } else {\n        reject(err);\n      }\n    });\n  });\n}\n\nexport interface RunOptions {\n  outputFolder?: string;\n  password?: string;\n  replaceInvalidChars?: string;\n  generateMarkdown?: boolean;\n  generateHtml?: boolean;\n  generateAnnotatedPdf?: boolean;\n  keepLineBreaks?: boolean;\n  contentSafetyOff?: string;\n  htmlInMarkdown?: boolean;\n  addImageToMarkdown?: boolean;\n  noJson?: boolean;\n  debug?: boolean;\n  useStructTree?: boolean;\n}\n\nexport function run(inputPath: string, options: RunOptions = {}): Promise<string> {\n  return new Promise((resolve, reject) => {\n    if (!fs.existsSync(inputPath)) {\n      return reject(new Error(`Input file or folder not found: ${inputPath}`));\n    }\n\n    const args: string[] = [];\n    if (options.outputFolder) {\n      args.push('--output-dir', options.outputFolder);\n    }\n    if (options.password) {\n      args.push('--password', options.password);\n    }\n    if (options.replaceInvalidChars) {\n      args.push('--replace-invalid-chars', options.replaceInvalidChars);\n    }\n    if (options.generateMarkdown) {\n      args.push('--markdown');\n    }\n    if (options.generateHtml) {\n      args.push('--html');\n    }\n    if (options.generateAnnotatedPdf) {\n      args.push('--pdf');\n    }\n    if (options.keepLineBreaks) {\n      args.push('--keep-line-breaks');\n    }\n    if (options.contentSafetyOff) {\n      args.push('--content-safety-off', options.contentSafetyOff);\n    }\n    if (options.htmlInMarkdown) {\n      args.push('--markdown-with-html');\n    }\n    if (options.addImageToMarkdown) {\n      args.push('--markdown-with-images');\n    }\n    if (options.noJson) {\n      args.push('--no-json');\n    }\n    if (options.useStructTree) {\n      args.push('--use-struct-tree')\n    }\n\n    args.push(inputPath);\n    executeJar(args, {\n      debug: options.debug,\n      streamOutput: Boolean(options.debug),\n    })\n      .then(resolve)\n      .catch(reject);\n  });\n}\n\nexport interface ConvertOptions {\n  outputDir?: string;\n  password?: string;\n  format?: string[];\n  quiet?: boolean;\n  contentSafetyOff?: string[];\n  keepLineBreaks?: boolean;\n  replaceInvalidChars?: string;\n  useStructTree?: boolean;\n}\n\nexport function convert(inputPaths: string[], options: ConvertOptions = {}): Promise<string> {\n  if (inputPaths.length === 0) {\n    return Promise.reject(new Error('At least one input path must be provided.'));\n  }\n\n  for (const input of inputPaths) {\n    if (!fs.existsSync(input)) {\n      return Promise.reject(new Error(`Input file or folder not found: ${input}`));\n    }\n  }\n\n  const args: string[] = [...inputPaths];\n  if (options.outputDir) {\n    args.push('--output-dir', options.outputDir);\n  }\n  if (options.password) {\n    args.push('--password', options.password);\n  }\n  if (options.format && options.format.length > 0) {\n    args.push('--format', ...options.format);\n  }\n  if (options.quiet) {\n    args.push('--quiet');\n  }\n  if (options.contentSafetyOff && options.contentSafetyOff.length > 0) {\n    args.push('--content-safety-off', ...options.contentSafetyOff);\n  }\n  if (options.keepLineBreaks) {\n    args.push('--keep-line-breaks');\n  }\n  if (options.replaceInvalidChars) {\n    args.push('--replace-invalid-chars', options.replaceInvalidChars);\n  }\n  if (options.useStructTree) {\n    args.push('--use-struct-tree')\n  }\n\n  return executeJar(args, {\n    streamOutput: !options.quiet,\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/convert-options.generated.ts"],"sourcesContent":["import { spawn } from 'child_process';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { fileURLToPath } from 'url';\n\n// Re-export types and utilities from auto-generated file\nexport type { ConvertOptions } from './convert-options.generated.js';\nexport { buildArgs } from './convert-options.generated.js';\nimport type { ConvertOptions } from './convert-options.generated.js';\nimport { buildArgs } from './convert-options.generated.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nconst JAR_NAME = 'opendataloader-pdf-cli.jar';\n\ninterface JarExecutionOptions {\n  streamOutput?: boolean;\n}\n\nfunction executeJar(args: string[], executionOptions: JarExecutionOptions = {}): Promise<string> {\n  const { streamOutput = false } = executionOptions;\n\n  return new Promise((resolve, reject) => {\n    const jarPath = path.join(__dirname, '..', 'lib', JAR_NAME);\n\n    if (!fs.existsSync(jarPath)) {\n      return reject(\n        new Error(`JAR file not found at ${jarPath}. Please run the build script first.`),\n      );\n    }\n\n    const command = 'java';\n    const commandArgs = ['-jar', jarPath, ...args];\n\n    const javaProcess = spawn(command, commandArgs);\n\n    let stdout = '';\n    let stderr = '';\n\n    javaProcess.stdout.on('data', (data) => {\n      const chunk = data.toString();\n      if (streamOutput) {\n        process.stdout.write(chunk);\n      }\n      stdout += chunk;\n    });\n\n    javaProcess.stderr.on('data', (data) => {\n      const chunk = data.toString();\n      if (streamOutput) {\n        process.stderr.write(chunk);\n      }\n      stderr += chunk;\n    });\n\n    javaProcess.on('close', (code) => {\n      if (code === 0) {\n        resolve(stdout);\n      } else {\n        const errorOutput = stderr || stdout;\n        const error = new Error(\n          `The opendataloader-pdf CLI exited with code ${code}.\\n\\n${errorOutput}`,\n        );\n        reject(error);\n      }\n    });\n\n    javaProcess.on('error', (err: Error) => {\n      if (err.message.includes('ENOENT')) {\n        reject(\n          new Error(\n            \"'java' command not found. Please ensure Java is installed and in your system's PATH.\",\n          ),\n        );\n      } else {\n        reject(err);\n      }\n    });\n  });\n}\n\nexport function convert(\n  inputPaths: string | string[],\n  options: ConvertOptions = {},\n): Promise<string> {\n  const inputList = Array.isArray(inputPaths) ? inputPaths : [inputPaths];\n  if (inputList.length === 0) {\n    return Promise.reject(new Error('At least one input path must be provided.'));\n  }\n\n  for (const input of inputList) {\n    if (!fs.existsSync(input)) {\n      return Promise.reject(new Error(`Input file or folder not found: ${input}`));\n    }\n  }\n\n  const args: string[] = [...inputList, ...buildArgs(options)];\n\n  return executeJar(args, {\n    streamOutput: !options.quiet,\n  });\n}\n\n/**\n * @deprecated Use `convert()` and `ConvertOptions` instead. This function will be removed in a future version.\n */\nexport interface RunOptions {\n  outputFolder?: string;\n  password?: string;\n  replaceInvalidChars?: string;\n  generateMarkdown?: boolean;\n  generateHtml?: boolean;\n  generateAnnotatedPdf?: boolean;\n  keepLineBreaks?: boolean;\n  contentSafetyOff?: string;\n  htmlInMarkdown?: boolean;\n  addImageToMarkdown?: boolean;\n  noJson?: boolean;\n  debug?: boolean;\n  useStructTree?: boolean;\n}\n\n/**\n * @deprecated Use `convert()` instead. This function will be removed in a future version.\n */\nexport function run(inputPath: string, options: RunOptions = {}): Promise<string> {\n  console.warn(\n    'Warning: run() is deprecated and will be removed in a future version. Use convert() instead.',\n  );\n\n  // Build format array based on legacy boolean options\n  const formats: string[] = [];\n  if (!options.noJson) {\n    formats.push('json');\n  }\n  if (options.generateMarkdown) {\n    if (options.addImageToMarkdown) {\n      formats.push('markdown-with-images');\n    } else if (options.htmlInMarkdown) {\n      formats.push('markdown-with-html');\n    } else {\n      formats.push('markdown');\n    }\n  }\n  if (options.generateHtml) {\n    formats.push('html');\n  }\n  if (options.generateAnnotatedPdf) {\n    formats.push('pdf');\n  }\n\n  return convert(inputPath, {\n    outputDir: options.outputFolder,\n    password: options.password,\n    replaceInvalidChars: options.replaceInvalidChars,\n    keepLineBreaks: options.keepLineBreaks,\n    contentSafetyOff: options.contentSafetyOff,\n    useStructTree: options.useStructTree,\n    format: formats.length > 0 ? formats : undefined,\n    quiet: !options.debug,\n  });\n}\n","// AUTO-GENERATED FROM options.json - DO NOT EDIT DIRECTLY\n// Run `npm run generate-options` to regenerate\n\n/**\n * Options for the convert function.\n */\nexport interface ConvertOptions {\n  /** Directory where output files are written. Default: input file directory */\n  outputDir?: string;\n  /** Password for encrypted PDF files */\n  password?: string;\n  /** Output formats (comma-separated). Values: json, text, html, pdf, markdown, markdown-with-html, markdown-with-images. Default: json */\n  format?: string | string[];\n  /** Suppress console logging output */\n  quiet?: boolean;\n  /** Disable content safety filters. Values: all, hidden-text, off-page, tiny, hidden-ocg */\n  contentSafetyOff?: string | string[];\n  /** Preserve original line breaks in extracted text */\n  keepLineBreaks?: boolean;\n  /** Replacement character for invalid/unrecognized characters. Default: space */\n  replaceInvalidChars?: string;\n  /** Use PDF structure tree (tagged PDF) for reading order and semantic structure */\n  useStructTree?: boolean;\n  /** Table detection method. Values: cluster */\n  tableMethod?: string;\n  /** Reading order algorithm. Values: none, xycut. Default: none */\n  readingOrder?: string;\n  /** Separator between pages in Markdown output. Use %page-number% for page numbers. Default: none */\n  markdownPageSeparator?: string;\n  /** Separator between pages in text output. Use %page-number% for page numbers. Default: none */\n  textPageSeparator?: string;\n  /** Separator between pages in HTML output. Use %page-number% for page numbers. Default: none */\n  htmlPageSeparator?: string;\n  /** Embed images as Base64 data URIs instead of file path references */\n  embedImages?: boolean;\n  /** Output format for extracted images. Values: png, jpeg. Default: png */\n  imageFormat?: string;\n}\n\n/**\n * Options as parsed from CLI (all values are strings from commander).\n */\nexport interface CliOptions {\n  outputDir?: string;\n  password?: string;\n  format?: string;\n  quiet?: boolean;\n  contentSafetyOff?: string;\n  keepLineBreaks?: boolean;\n  replaceInvalidChars?: string;\n  useStructTree?: boolean;\n  tableMethod?: string;\n  readingOrder?: string;\n  markdownPageSeparator?: string;\n  textPageSeparator?: string;\n  htmlPageSeparator?: string;\n  embedImages?: boolean;\n  imageFormat?: string;\n}\n\n/**\n * Convert CLI options to ConvertOptions.\n */\nexport function buildConvertOptions(cliOptions: CliOptions): ConvertOptions {\n  const convertOptions: ConvertOptions = {};\n\n  if (cliOptions.outputDir) {\n    convertOptions.outputDir = cliOptions.outputDir;\n  }\n  if (cliOptions.password) {\n    convertOptions.password = cliOptions.password;\n  }\n  if (cliOptions.format) {\n    convertOptions.format = cliOptions.format;\n  }\n  if (cliOptions.quiet) {\n    convertOptions.quiet = true;\n  }\n  if (cliOptions.contentSafetyOff) {\n    convertOptions.contentSafetyOff = cliOptions.contentSafetyOff;\n  }\n  if (cliOptions.keepLineBreaks) {\n    convertOptions.keepLineBreaks = true;\n  }\n  if (cliOptions.replaceInvalidChars) {\n    convertOptions.replaceInvalidChars = cliOptions.replaceInvalidChars;\n  }\n  if (cliOptions.useStructTree) {\n    convertOptions.useStructTree = true;\n  }\n  if (cliOptions.tableMethod) {\n    convertOptions.tableMethod = cliOptions.tableMethod;\n  }\n  if (cliOptions.readingOrder) {\n    convertOptions.readingOrder = cliOptions.readingOrder;\n  }\n  if (cliOptions.markdownPageSeparator) {\n    convertOptions.markdownPageSeparator = cliOptions.markdownPageSeparator;\n  }\n  if (cliOptions.textPageSeparator) {\n    convertOptions.textPageSeparator = cliOptions.textPageSeparator;\n  }\n  if (cliOptions.htmlPageSeparator) {\n    convertOptions.htmlPageSeparator = cliOptions.htmlPageSeparator;\n  }\n  if (cliOptions.embedImages) {\n    convertOptions.embedImages = true;\n  }\n  if (cliOptions.imageFormat) {\n    convertOptions.imageFormat = cliOptions.imageFormat;\n  }\n\n  return convertOptions;\n}\n\n/**\n * Build CLI arguments array from ConvertOptions.\n */\nexport function buildArgs(options: ConvertOptions): string[] {\n  const args: string[] = [];\n\n  if (options.outputDir) {\n    args.push('--output-dir', options.outputDir);\n  }\n  if (options.password) {\n    args.push('--password', options.password);\n  }\n  if (options.format) {\n    if (Array.isArray(options.format)) {\n      if (options.format.length > 0) {\n        args.push('--format', options.format.join(','));\n      }\n    } else {\n      args.push('--format', options.format);\n    }\n  }\n  if (options.quiet) {\n    args.push('--quiet');\n  }\n  if (options.contentSafetyOff) {\n    if (Array.isArray(options.contentSafetyOff)) {\n      if (options.contentSafetyOff.length > 0) {\n        args.push('--content-safety-off', options.contentSafetyOff.join(','));\n      }\n    } else {\n      args.push('--content-safety-off', options.contentSafetyOff);\n    }\n  }\n  if (options.keepLineBreaks) {\n    args.push('--keep-line-breaks');\n  }\n  if (options.replaceInvalidChars) {\n    args.push('--replace-invalid-chars', options.replaceInvalidChars);\n  }\n  if (options.useStructTree) {\n    args.push('--use-struct-tree');\n  }\n  if (options.tableMethod) {\n    args.push('--table-method', options.tableMethod);\n  }\n  if (options.readingOrder) {\n    args.push('--reading-order', options.readingOrder);\n  }\n  if (options.markdownPageSeparator) {\n    args.push('--markdown-page-separator', options.markdownPageSeparator);\n  }\n  if (options.textPageSeparator) {\n    args.push('--text-page-separator', options.textPageSeparator);\n  }\n  if (options.htmlPageSeparator) {\n    args.push('--html-page-separator', options.htmlPageSeparator);\n  }\n  if (options.embedImages) {\n    args.push('--embed-images');\n  }\n  if (options.imageFormat) {\n    args.push('--image-format', options.imageFormat);\n  }\n\n  return args;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,3 +1,47 @@
+/**
+ * Options for the convert function.
+ */
+interface ConvertOptions {
+    /** Directory where output files are written. Default: input file directory */
+    outputDir?: string;
+    /** Password for encrypted PDF files */
+    password?: string;
+    /** Output formats (comma-separated). Values: json, text, html, pdf, markdown, markdown-with-html, markdown-with-images. Default: json */
+    format?: string | string[];
+    /** Suppress console logging output */
+    quiet?: boolean;
+    /** Disable content safety filters. Values: all, hidden-text, off-page, tiny, hidden-ocg */
+    contentSafetyOff?: string | string[];
+    /** Preserve original line breaks in extracted text */
+    keepLineBreaks?: boolean;
+    /** Replacement character for invalid/unrecognized characters. Default: space */
+    replaceInvalidChars?: string;
+    /** Use PDF structure tree (tagged PDF) for reading order and semantic structure */
+    useStructTree?: boolean;
+    /** Table detection method. Values: cluster */
+    tableMethod?: string;
+    /** Reading order algorithm. Values: none, xycut. Default: none */
+    readingOrder?: string;
+    /** Separator between pages in Markdown output. Use %page-number% for page numbers. Default: none */
+    markdownPageSeparator?: string;
+    /** Separator between pages in text output. Use %page-number% for page numbers. Default: none */
+    textPageSeparator?: string;
+    /** Separator between pages in HTML output. Use %page-number% for page numbers. Default: none */
+    htmlPageSeparator?: string;
+    /** Embed images as Base64 data URIs instead of file path references */
+    embedImages?: boolean;
+    /** Output format for extracted images. Values: png, jpeg. Default: png */
+    imageFormat?: string;
+}
+/**
+ * Build CLI arguments array from ConvertOptions.
+ */
+declare function buildArgs(options: ConvertOptions): string[];
+
+declare function convert(inputPaths: string | string[], options?: ConvertOptions): Promise<string>;
+/**
+ * @deprecated Use `convert()` and `ConvertOptions` instead. This function will be removed in a future version.
+ */
 interface RunOptions {
     outputFolder?: string;
     password?: string;
@@ -13,17 +57,9 @@ interface RunOptions {
     debug?: boolean;
     useStructTree?: boolean;
 }
+/**
+ * @deprecated Use `convert()` instead. This function will be removed in a future version.
+ */
 declare function run(inputPath: string, options?: RunOptions): Promise<string>;
-interface ConvertOptions {
-    outputDir?: string;
-    password?: string;
-    format?: string[];
-    quiet?: boolean;
-    contentSafetyOff?: string[];
-    keepLineBreaks?: boolean;
-    replaceInvalidChars?: string;
-    useStructTree?: boolean;
-}
-declare function convert(inputPaths: string[], options?: ConvertOptions): Promise<string>;
 
-export { type ConvertOptions, type RunOptions, convert, run };
+export { type ConvertOptions, type RunOptions, buildArgs, convert, run };

package/dist/index.d.ts

@@ -1,3 +1,47 @@
+/**
+ * Options for the convert function.
+ */
+interface ConvertOptions {
+    /** Directory where output files are written. Default: input file directory */
+    outputDir?: string;
+    /** Password for encrypted PDF files */
+    password?: string;
+    /** Output formats (comma-separated). Values: json, text, html, pdf, markdown, markdown-with-html, markdown-with-images. Default: json */
+    format?: string | string[];
+    /** Suppress console logging output */
+    quiet?: boolean;
+    /** Disable content safety filters. Values: all, hidden-text, off-page, tiny, hidden-ocg */
+    contentSafetyOff?: string | string[];
+    /** Preserve original line breaks in extracted text */
+    keepLineBreaks?: boolean;
+    /** Replacement character for invalid/unrecognized characters. Default: space */
+    replaceInvalidChars?: string;
+    /** Use PDF structure tree (tagged PDF) for reading order and semantic structure */
+    useStructTree?: boolean;
+    /** Table detection method. Values: cluster */
+    tableMethod?: string;
+    /** Reading order algorithm. Values: none, xycut. Default: none */
+    readingOrder?: string;
+    /** Separator between pages in Markdown output. Use %page-number% for page numbers. Default: none */
+    markdownPageSeparator?: string;
+    /** Separator between pages in text output. Use %page-number% for page numbers. Default: none */
+    textPageSeparator?: string;
+    /** Separator between pages in HTML output. Use %page-number% for page numbers. Default: none */
+    htmlPageSeparator?: string;
+    /** Embed images as Base64 data URIs instead of file path references */
+    embedImages?: boolean;
+    /** Output format for extracted images. Values: png, jpeg. Default: png */
+    imageFormat?: string;
+}
+/**
+ * Build CLI arguments array from ConvertOptions.
+ */
+declare function buildArgs(options: ConvertOptions): string[];
+
+declare function convert(inputPaths: string | string[], options?: ConvertOptions): Promise<string>;
+/**
+ * @deprecated Use `convert()` and `ConvertOptions` instead. This function will be removed in a future version.
+ */
 interface RunOptions {
     outputFolder?: string;
     password?: string;
@@ -13,17 +57,9 @@ interface RunOptions {
     debug?: boolean;
     useStructTree?: boolean;
 }
+/**
+ * @deprecated Use `convert()` instead. This function will be removed in a future version.
+ */
 declare function run(inputPath: string, options?: RunOptions): Promise<string>;
-interface ConvertOptions {
-    outputDir?: string;
-    password?: string;
-    format?: string[];
-    quiet?: boolean;
-    contentSafetyOff?: string[];
-    keepLineBreaks?: boolean;
-    replaceInvalidChars?: string;
-    useStructTree?: boolean;
-}
-declare function convert(inputPaths: string[], options?: ConvertOptions): Promise<string>;
 
-export { type ConvertOptions, type RunOptions, convert, run };
+export { type ConvertOptions, type RunOptions, buildArgs, convert, run };