Introduced output template

README.md

@@ -91,6 +91,7 @@ Options:
   -f, --print-format <format>  format to export
   -d, --date-field <field>     date field to use (default: "posting_date")
   -ds, --docstatus <status>    docstatus to filter on
+  -ot, --output-template       output filename template (e.g. "{customer_name} - {name}")
   --include-json               also export JSON file
   -h, --help                   display help for command
 ```

controllers/export-to-pdf.ts

@@ -13,6 +13,15 @@ export interface ExportToPdfOptions {
     targetDir: string;
     printFormat?: string;
     includeJson?: boolean;
+    outputTemplate?: string;
+}
+
+function generateFilename(template: string | undefined, document: any, name: string): string {
+    if (!template) return name;
+
+    return template.replace(/{(\w+)}/g, (match, key) => {
+        return document[key] || match;
+    });
 }
 
 export async function exportToPdf(opts: ExportToPdfOptions) {
@@ -50,8 +59,10 @@ export async function exportToPdf(opts: ExportToPdfOptions) {
             await mkdir(targetDir, { recursive: true });
         }
 
+        const baseFilename = generateFilename(opts.outputTemplate, document, opts.name);
+
         // Save the PDF file if it doesn't exist
-        const pdfFilename = path.join(targetDir, `${opts.name}.pdf`);
+        const pdfFilename = path.join(targetDir, `${baseFilename}.pdf`);
 
         if (await exists(pdfFilename)) {
             // Stop processing if the file already exists
@@ -63,7 +74,7 @@ export async function exportToPdf(opts: ExportToPdfOptions) {
 
         if (opts.includeJson) {
             // Save the json file
-            const jsonFilename = path.join(targetDir, `${opts.name}.json`);
+            const jsonFilename = path.join(targetDir, `${baseFilename}.json`);
             console.log(`Saving ${opts.doctype} ${opts.name} to ${jsonFilename}`);
             await Bun.write(jsonFilename, JSON.stringify(document));
         }

index.ts

@@ -19,6 +19,7 @@ program.command('watch')
     .option('-f, --print-format <format>', 'format to export')
     .option('-d, --date-field <field>', 'date field to use', 'posting_date')
     .option('-ds, --docstatus <status>', 'docstatus to filter on')
+    .option('-ot, --output-template <template>', 'output filename template e.g. "{customer_name} - {name}"', '{name}')
     .option('--include-json', 'also export JSON file')
     .action(async (doctype: string, options: any) => {
         while (true) {
@@ -45,7 +46,8 @@ program.command('watch')
                             dateField: options.dateField,
                             targetDir: options.targetDir,
                             printFormat: options.printFormat,
-                            includeJson: options.includeJson
+                            outputTemplate: options.outputTemplate,
+                            includeJson: options.includeJson,
                         });
 
                         if (exportedDocument !== null && (newLastTimestamp === null || exportedDocument.modified > newLastTimestamp)) {

package.json

@@ -2,7 +2,7 @@
   "name": "erpnext-documents-export",
   "module": "index.ts",
   "type": "module",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "devDependencies": {
     "@types/bun": "latest"
   },