@plevands/epson-thermal-printer 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["intervalId: ReturnType<typeof setInterval> | null","DEFAULT_CONFIG: EpsonPrinterConfig"],"sources":["../src/hooks/useEpsonPrinter.ts","../src/hooks/usePrinterConfig.ts","../src/hooks/usePdfProcessor.ts"],"sourcesContent":["/**\n * React hook for Epson printer operations\n */\n\nimport { useState, useCallback, useEffect } from 'react';\nimport { EposPrintService, checkEpsonSDKStatus } from '../lib/epos-print';\nimport type { \n  EpsonPrinterConfig, \n  PrintResult, \n  PrintOptions,\n  UseEpsonPrinterReturn,\n  PrinterStatus,\n} from '../types';\n\nexport function useEpsonPrinter(\n  config: EpsonPrinterConfig,\n  options?: PrintOptions\n): UseEpsonPrinterReturn {\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const [sdkStatus, setSdkStatus] = useState<PrinterStatus>({\n    loaded: false,\n    loading: false,\n    error: null,\n    classes: [],\n  });\n\n  // Check SDK status periodically until loaded\n  useEffect(() => {\n    let intervalId: ReturnType<typeof setInterval> | null = null;\n    \n    const checkStatus = () => {\n      const status = checkEpsonSDKStatus();\n      setSdkStatus(status);\n      \n      // Stop checking once SDK is loaded\n      if (status.loaded && intervalId !== null) {\n        clearInterval(intervalId);\n        intervalId = null;\n      }\n    };\n    \n    // Initial check\n    const initialStatus = checkEpsonSDKStatus();\n    setSdkStatus(initialStatus);\n    \n    // Only start interval if SDK is not loaded yet\n    if (!initialStatus.loaded) {\n      intervalId = setInterval(checkStatus, 1000);\n    }\n\n    return () => {\n      if (intervalId !== null) {\n        clearInterval(intervalId);\n      }\n    };\n  }, []); // Empty deps - only run on mount\n\n  const print = useCallback(\n    async (canvas: HTMLCanvasElement): Promise<PrintResult> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const service = new EposPrintService(config, options);\n        const result = await service.printCanvas(canvas);\n\n        if (!result.success) {\n          setError(result.message || 'Print failed');\n        }\n\n        return result;\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : 'Unknown error';\n        setError(errorMessage);\n        return {\n          success: false,\n          code: 'ERROR',\n          message: errorMessage,\n        };\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [config, options]\n  );\n\n  const printPages = useCallback(\n    async (\n      canvases: HTMLCanvasElement[],\n      pageOptions?: {\n        pageSelection?: 'all' | number[];\n        headerText?: string;\n        footerText?: string;\n      }\n    ): Promise<PrintResult> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const service = new EposPrintService(config, options);\n\n        // Filter canvases based on page selection\n        let selectedCanvases = canvases;\n        if (pageOptions?.pageSelection && pageOptions.pageSelection !== 'all') {\n          selectedCanvases = pageOptions.pageSelection\n            .map(pageNum => canvases[pageNum - 1])\n            .filter(Boolean);\n        }\n\n        const result = await service.printPages(selectedCanvases, {\n          header: pageOptions?.headerText,\n          footer: pageOptions?.footerText,\n        });\n\n        if (!result.success) {\n          setError(result.message || 'Print failed');\n        }\n\n        return result;\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : 'Unknown error';\n        setError(errorMessage);\n        return {\n          success: false,\n          code: 'ERROR',\n          message: errorMessage,\n        };\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [config, options]\n  );\n\n  const testConnection = useCallback(async (): Promise<PrintResult> => {\n    setIsLoading(true);\n    setError(null);\n\n    try {\n      const service = new EposPrintService(config, options);\n      \n      // Use the service's testConnection method which prints a test receipt\n      const result = await service.testConnection();\n\n      if (!result.success) {\n        setError(result.message || 'Connection test failed');\n      }\n\n      return result;\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : 'Unknown error';\n      setError(errorMessage);\n      return {\n        success: false,\n        code: 'ERROR',\n        message: errorMessage,\n      };\n    } finally {\n      setIsLoading(false);\n    }\n  }, [config, options]);\n\n  return {\n    print,\n    printPages,\n    testConnection,\n    isLoading,\n    error,\n    sdkStatus,\n  };\n}\n","/**\n * React hook for managing printer configuration with localStorage persistence\n */\n\nimport { useState, useCallback, useEffect } from 'react';\nimport type { EpsonPrinterConfig, UsePrinterConfigReturn } from '../types';\nimport { error } from '../lib/logger';\n\nconst STORAGE_KEY = 'epson-printer-config';\n\nconst DEFAULT_CONFIG: EpsonPrinterConfig = {\n  printerIP: '192.168.1.100',\n  printerPort: 80,\n  deviceId: 'local_printer',\n  timeout: 60000,\n};\n\nexport function usePrinterConfig(): UsePrinterConfigReturn {\n  const [config, setConfig] = useState<EpsonPrinterConfig>(() => {\n    // Load from localStorage on mount\n    try {\n      const stored = localStorage.getItem(STORAGE_KEY);\n      if (stored) {\n        return { ...DEFAULT_CONFIG, ...JSON.parse(stored) };\n      }\n    } catch (err) {\n      error('Failed to load printer config from localStorage:', err);\n    }\n    return DEFAULT_CONFIG;\n  });\n\n  // Save to localStorage whenever config changes\n  useEffect(() => {\n    try {\n      localStorage.setItem(STORAGE_KEY, JSON.stringify(config));\n    } catch (err) {\n      error('Failed to save printer config to localStorage:', err);\n    }\n  }, [config]);\n\n  const updateConfig = useCallback((newConfig: Partial<EpsonPrinterConfig>) => {\n    setConfig(prev => ({ ...prev, ...newConfig }));\n  }, []);\n\n  const resetConfig = useCallback(() => {\n    setConfig(DEFAULT_CONFIG);\n    try {\n      localStorage.removeItem(STORAGE_KEY);\n    } catch (err) {\n      error('Failed to remove printer config from localStorage:', err);\n    }\n  }, []);\n\n  const isConfigured = Boolean(\n    config.printerIP && \n    config.printerIP.trim() !== '' && \n    config.printerIP !== '0.0.0.0'\n  );\n\n  return {\n    config,\n    updateConfig,\n    resetConfig,\n    isConfigured,\n  };\n}\n","/**\n * React hook for PDF processing operations\n */\n\nimport { useState, useCallback } from 'react';\nimport { processPdfFile } from '../lib/pdf-processor';\nimport type { \n  PdfProcessingConfig, \n  ProcessedPage,\n  UsePdfProcessorReturn,\n} from '../types';\n\nexport function usePdfProcessor(\n  config?: PdfProcessingConfig\n): UsePdfProcessorReturn {\n  const [isProcessing, setIsProcessing] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  const processFile = useCallback(\n    async (file: File): Promise<ProcessedPage[]> => {\n      setIsProcessing(true);\n      setError(null);\n\n      try {\n        const pages = await processPdfFile(file, config);\n        return pages;\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : 'Failed to process PDF';\n        setError(errorMessage);\n        throw err;\n      } finally {\n        setIsProcessing(false);\n      }\n    },\n    [config]\n  );\n\n  return {\n    processFile,\n    isProcessing,\n    error,\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @plevands/epson-thermal-printer
+ * Main library exports
+ */
+export { EposPrintService, checkEpsonSDKStatus } from './lib/epos-print';
+export { loadEpsonSDK, isEpsonSDKLoaded, initializeEpsonSDK, getEpsonSDK, getLoaderState, resetLoaderState, } from './lib/epson-sdk-loader';
+export { processPdfPage, processPdfFile, DEFAULT_PDF_CONFIG, } from './lib/pdf-processor';
+export { configureLogger, getLoggerConfig } from './lib/logger';
+export { useEpsonPrinter } from './hooks/useEpsonPrinter';
+export { usePrinterConfig } from './hooks/usePrinterConfig';
+export { usePdfProcessor } from './hooks/usePdfProcessor';
+export type { EpsonPrinterConfig, PrintResult, PrintOptions, PdfProcessingConfig, ProcessedPage, LoaderState, SDKLoadOptions, InitializeSDKResult, PrinterStatus, UseEpsonPrinterReturn, UsePrinterConfigReturn, UsePdfProcessorReturn, LogLevel, LogEntry, LoggerConfig, } from './types';

package/dist/index.js

@@ -0,0 +1,140 @@
+import { a as checkEpsonSDKStatus, c as initializeEpsonSDK, d as resetLoaderState, f as configureLogger, h as getLoggerConfig, i as EposPrintService, l as isEpsonSDKLoaded, m as error, n as processPdfFile, o as getEpsonSDK, r as processPdfPage, s as getLoaderState, t as DEFAULT_PDF_CONFIG, u as loadEpsonSDK } from "./pdf-processor-B7cA9poK.js";
+import { useCallback, useEffect, useState } from "react";
+function useEpsonPrinter(m, h) {
+	let [g, _] = useState(!1), [v, y] = useState(null), [b, x] = useState({
+		loaded: !1,
+		loading: !1,
+		error: null,
+		classes: []
+	});
+	return useEffect(() => {
+		let m = null, h = () => {
+			let h = checkEpsonSDKStatus();
+			x(h), h.loaded && m !== null && (clearInterval(m), m = null);
+		}, g = checkEpsonSDKStatus();
+		return x(g), g.loaded || (m = setInterval(h, 1e3)), () => {
+			m !== null && clearInterval(m);
+		};
+	}, []), {
+		print: useCallback(async (e) => {
+			_(!0), y(null);
+			try {
+				let g = await new EposPrintService(m, h).printCanvas(e);
+				return g.success || y(g.message || "Print failed"), g;
+			} catch (e) {
+				let m = e instanceof Error ? e.message : "Unknown error";
+				return y(m), {
+					success: !1,
+					code: "ERROR",
+					message: m
+				};
+			} finally {
+				_(!1);
+			}
+		}, [m, h]),
+		printPages: useCallback(async (e, g) => {
+			_(!0), y(null);
+			try {
+				let _ = new EposPrintService(m, h), v = e;
+				g?.pageSelection && g.pageSelection !== "all" && (v = g.pageSelection.map((m) => e[m - 1]).filter(Boolean));
+				let b = await _.printPages(v, {
+					header: g?.headerText,
+					footer: g?.footerText
+				});
+				return b.success || y(b.message || "Print failed"), b;
+			} catch (e) {
+				let m = e instanceof Error ? e.message : "Unknown error";
+				return y(m), {
+					success: !1,
+					code: "ERROR",
+					message: m
+				};
+			} finally {
+				_(!1);
+			}
+		}, [m, h]),
+		testConnection: useCallback(async () => {
+			_(!0), y(null);
+			try {
+				let e = await new EposPrintService(m, h).testConnection();
+				return e.success || y(e.message || "Connection test failed"), e;
+			} catch (e) {
+				let m = e instanceof Error ? e.message : "Unknown error";
+				return y(m), {
+					success: !1,
+					code: "ERROR",
+					message: m
+				};
+			} finally {
+				_(!1);
+			}
+		}, [m, h]),
+		isLoading: g,
+		error: v,
+		sdkStatus: b
+	};
+}
+var STORAGE_KEY = "epson-printer-config", DEFAULT_CONFIG = {
+	printerIP: "192.168.1.100",
+	printerPort: 80,
+	deviceId: "local_printer",
+	timeout: 6e4
+};
+function usePrinterConfig() {
+	let [e, m] = useState(() => {
+		try {
+			let e = localStorage.getItem(STORAGE_KEY);
+			if (e) return {
+				...DEFAULT_CONFIG,
+				...JSON.parse(e)
+			};
+		} catch (e) {
+			error("Failed to load printer config from localStorage:", e);
+		}
+		return DEFAULT_CONFIG;
+	});
+	return useEffect(() => {
+		try {
+			localStorage.setItem(STORAGE_KEY, JSON.stringify(e));
+		} catch (e) {
+			error("Failed to save printer config to localStorage:", e);
+		}
+	}, [e]), {
+		config: e,
+		updateConfig: useCallback((e) => {
+			m((m) => ({
+				...m,
+				...e
+			}));
+		}, []),
+		resetConfig: useCallback(() => {
+			m(DEFAULT_CONFIG);
+			try {
+				localStorage.removeItem(STORAGE_KEY);
+			} catch (e) {
+				error("Failed to remove printer config from localStorage:", e);
+			}
+		}, []),
+		isConfigured: !!(e.printerIP && e.printerIP.trim() !== "" && e.printerIP !== "0.0.0.0")
+	};
+}
+function usePdfProcessor(e) {
+	let [m, h] = useState(!1), [g, _] = useState(null);
+	return {
+		processFile: useCallback(async (m) => {
+			h(!0), _(null);
+			try {
+				return await processPdfFile(m, e);
+			} catch (e) {
+				throw _(e instanceof Error ? e.message : "Failed to process PDF"), e;
+			} finally {
+				h(!1);
+			}
+		}, [e]),
+		isProcessing: m,
+		error: g
+	};
+}
+export { DEFAULT_PDF_CONFIG, EposPrintService, checkEpsonSDKStatus, configureLogger, getEpsonSDK, getLoaderState, getLoggerConfig, initializeEpsonSDK, isEpsonSDKLoaded, loadEpsonSDK, processPdfFile, processPdfPage, resetLoaderState, useEpsonPrinter, usePdfProcessor, usePrinterConfig };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["intervalId: ReturnType<typeof setInterval> | null","DEFAULT_CONFIG: EpsonPrinterConfig"],"sources":["../src/hooks/useEpsonPrinter.ts","../src/hooks/usePrinterConfig.ts","../src/hooks/usePdfProcessor.ts"],"sourcesContent":["/**\n * React hook for Epson printer operations\n */\n\nimport { useState, useCallback, useEffect } from 'react';\nimport { EposPrintService, checkEpsonSDKStatus } from '../lib/epos-print';\nimport type { \n  EpsonPrinterConfig, \n  PrintResult, \n  PrintOptions,\n  UseEpsonPrinterReturn,\n  PrinterStatus,\n} from '../types';\n\nexport function useEpsonPrinter(\n  config: EpsonPrinterConfig,\n  options?: PrintOptions\n): UseEpsonPrinterReturn {\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const [sdkStatus, setSdkStatus] = useState<PrinterStatus>({\n    loaded: false,\n    loading: false,\n    error: null,\n    classes: [],\n  });\n\n  // Check SDK status periodically until loaded\n  useEffect(() => {\n    let intervalId: ReturnType<typeof setInterval> | null = null;\n    \n    const checkStatus = () => {\n      const status = checkEpsonSDKStatus();\n      setSdkStatus(status);\n      \n      // Stop checking once SDK is loaded\n      if (status.loaded && intervalId !== null) {\n        clearInterval(intervalId);\n        intervalId = null;\n      }\n    };\n    \n    // Initial check\n    const initialStatus = checkEpsonSDKStatus();\n    setSdkStatus(initialStatus);\n    \n    // Only start interval if SDK is not loaded yet\n    if (!initialStatus.loaded) {\n      intervalId = setInterval(checkStatus, 1000);\n    }\n\n    return () => {\n      if (intervalId !== null) {\n        clearInterval(intervalId);\n      }\n    };\n  }, []); // Empty deps - only run on mount\n\n  const print = useCallback(\n    async (canvas: HTMLCanvasElement): Promise<PrintResult> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const service = new EposPrintService(config, options);\n        const result = await service.printCanvas(canvas);\n\n        if (!result.success) {\n          setError(result.message || 'Print failed');\n        }\n\n        return result;\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : 'Unknown error';\n        setError(errorMessage);\n        return {\n          success: false,\n          code: 'ERROR',\n          message: errorMessage,\n        };\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [config, options]\n  );\n\n  const printPages = useCallback(\n    async (\n      canvases: HTMLCanvasElement[],\n      pageOptions?: {\n        pageSelection?: 'all' | number[];\n        headerText?: string;\n        footerText?: string;\n      }\n    ): Promise<PrintResult> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const service = new EposPrintService(config, options);\n\n        // Filter canvases based on page selection\n        let selectedCanvases = canvases;\n        if (pageOptions?.pageSelection && pageOptions.pageSelection !== 'all') {\n          selectedCanvases = pageOptions.pageSelection\n            .map(pageNum => canvases[pageNum - 1])\n            .filter(Boolean);\n        }\n\n        const result = await service.printPages(selectedCanvases, {\n          header: pageOptions?.headerText,\n          footer: pageOptions?.footerText,\n        });\n\n        if (!result.success) {\n          setError(result.message || 'Print failed');\n        }\n\n        return result;\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : 'Unknown error';\n        setError(errorMessage);\n        return {\n          success: false,\n          code: 'ERROR',\n          message: errorMessage,\n        };\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [config, options]\n  );\n\n  const testConnection = useCallback(async (): Promise<PrintResult> => {\n    setIsLoading(true);\n    setError(null);\n\n    try {\n      const service = new EposPrintService(config, options);\n      \n      // Use the service's testConnection method which prints a test receipt\n      const result = await service.testConnection();\n\n      if (!result.success) {\n        setError(result.message || 'Connection test failed');\n      }\n\n      return result;\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : 'Unknown error';\n      setError(errorMessage);\n      return {\n        success: false,\n        code: 'ERROR',\n        message: errorMessage,\n      };\n    } finally {\n      setIsLoading(false);\n    }\n  }, [config, options]);\n\n  return {\n    print,\n    printPages,\n    testConnection,\n    isLoading,\n    error,\n    sdkStatus,\n  };\n}\n","/**\n * React hook for managing printer configuration with localStorage persistence\n */\n\nimport { useState, useCallback, useEffect } from 'react';\nimport type { EpsonPrinterConfig, UsePrinterConfigReturn } from '../types';\nimport { error } from '../lib/logger';\n\nconst STORAGE_KEY = 'epson-printer-config';\n\nconst DEFAULT_CONFIG: EpsonPrinterConfig = {\n  printerIP: '192.168.1.100',\n  printerPort: 80,\n  deviceId: 'local_printer',\n  timeout: 60000,\n};\n\nexport function usePrinterConfig(): UsePrinterConfigReturn {\n  const [config, setConfig] = useState<EpsonPrinterConfig>(() => {\n    // Load from localStorage on mount\n    try {\n      const stored = localStorage.getItem(STORAGE_KEY);\n      if (stored) {\n        return { ...DEFAULT_CONFIG, ...JSON.parse(stored) };\n      }\n    } catch (err) {\n      error('Failed to load printer config from localStorage:', err);\n    }\n    return DEFAULT_CONFIG;\n  });\n\n  // Save to localStorage whenever config changes\n  useEffect(() => {\n    try {\n      localStorage.setItem(STORAGE_KEY, JSON.stringify(config));\n    } catch (err) {\n      error('Failed to save printer config to localStorage:', err);\n    }\n  }, [config]);\n\n  const updateConfig = useCallback((newConfig: Partial<EpsonPrinterConfig>) => {\n    setConfig(prev => ({ ...prev, ...newConfig }));\n  }, []);\n\n  const resetConfig = useCallback(() => {\n    setConfig(DEFAULT_CONFIG);\n    try {\n      localStorage.removeItem(STORAGE_KEY);\n    } catch (err) {\n      error('Failed to remove printer config from localStorage:', err);\n    }\n  }, []);\n\n  const isConfigured = Boolean(\n    config.printerIP && \n    config.printerIP.trim() !== '' && \n    config.printerIP !== '0.0.0.0'\n  );\n\n  return {\n    config,\n    updateConfig,\n    resetConfig,\n    isConfigured,\n  };\n}\n","/**\n * React hook for PDF processing operations\n */\n\nimport { useState, useCallback } from 'react';\nimport { processPdfFile } from '../lib/pdf-processor';\nimport type { \n  PdfProcessingConfig, \n  ProcessedPage,\n  UsePdfProcessorReturn,\n} from '../types';\n\nexport function usePdfProcessor(\n  config?: PdfProcessingConfig\n): UsePdfProcessorReturn {\n  const [isProcessing, setIsProcessing] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  const processFile = useCallback(\n    async (file: File): Promise<ProcessedPage[]> => {\n      setIsProcessing(true);\n      setError(null);\n\n      try {\n        const pages = await processPdfFile(file, config);\n        return pages;\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : 'Failed to process PDF';\n        setError(errorMessage);\n        throw err;\n      } finally {\n        setIsProcessing(false);\n      }\n    },\n    [config]\n  );\n\n  return {\n    processFile,\n    isProcessing,\n    error,\n  };\n}\n"],"mappings":"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"}

package/dist/lib/epos-print.d.ts

@@ -0,0 +1,116 @@
+import { epson } from './epson-sdk';
+import { loadEpsonSDK, isEpsonSDKLoaded, getLoaderState, initializeEpsonSDK } from './epson-sdk-loader';
+import { EpsonPrinterConfig, PrintResult, PrintOptions } from '../types';
+export type { EpsonPrinterConfig, PrintResult, PrintOptions } from '../types';
+export { loadEpsonSDK, isEpsonSDKLoaded, initializeEpsonSDK, getLoaderState, };
+/**
+ * Check SDK status - useful for debugging
+ */
+export declare function checkEpsonSDKStatus(): {
+    loaded: boolean;
+    loading: boolean;
+    error: Error | null;
+    classes: string[];
+};
+/**
+ * ePOS Print Service using official SDK
+ */
+export declare class EposPrintService {
+    private config;
+    private printOptions;
+    private initPromise;
+    constructor(config: EpsonPrinterConfig, options?: PrintOptions);
+    /**
+     * Ensure SDK is loaded before any print operation (lazy loading)
+     */
+    private ensureSDKLoaded;
+    /**
+     * Get the printer URL for ePOS Print
+     */
+    private getPrinterUrl;
+    /**
+     * Print a canvas element using ePOSBuilder
+     *
+     * IMPORTANT: We don't use CanvasPrint.print() directly due to an SDK bug.
+     * The SDK's prototypal inheritance causes CanvasPrint.print() to call
+     * this.send(printjobid) which internally creates a new empty ePOSBuilder,
+     * ignoring all the commands built in 'this'.
+     *
+     * Instead, we use ePOSBuilder to construct the print commands manually,
+     * get the XML, and send it via ePOSPrint.send(xml).
+     */
+    printCanvas(canvas: HTMLCanvasElement): Promise<PrintResult>;
+    /**
+     * Get alignment value for SDK (instance property values are strings)
+     */
+    private getAlignValue;
+    /**
+     * Print using ePOSPrint with builder pattern
+     */
+    printWithBuilder(buildFn: (builder: epson.ePOSBuilder) => void): Promise<PrintResult>;
+    /**
+     * Print multiple canvases (pages) with optional header/footer
+     */
+    printPages(canvases: HTMLCanvasElement[], options?: {
+        header?: string;
+        footer?: string;
+        pageSeparator?: boolean;
+    }): Promise<PrintResult>;
+    /**
+     * Test printer connection
+     */
+    testConnection(): Promise<PrintResult>;
+    /**
+     * Print a test page
+     */
+    printTestPage(): Promise<PrintResult>;
+}
+/**
+ * PDF to Canvas conversion utilities
+ */
+export declare function pdfToCanvases(pdfFile: File, options?: {
+    scale?: number;
+    maxWidth?: number;
+}): Promise<{
+    canvas: HTMLCanvasElement;
+    width: number;
+    height: number;
+}[]>;
+/**
+ * Convert image file to canvas
+ */
+export declare function imageToCanvas(file: File, maxWidth?: number): Promise<{
+    canvas: HTMLCanvasElement;
+    width: number;
+    height: number;
+}>;
+export declare class EposPrintBuilder {
+    private builder;
+    constructor();
+    reset(): this;
+    addText(text: string): this;
+    addTextLine(text: string): this;
+    addFeedLine(lines?: number): this;
+    addCut(type?: 'no_feed' | 'feed' | 'reserve'): this;
+    addTextAlign(align: 'left' | 'center' | 'right'): this;
+    addTextStyle(reverse?: boolean, underline?: boolean, bold?: boolean, color?: 'color_1' | 'color_2' | 'color_3' | 'color_4'): this;
+    addTextSize(width?: number, height?: number): this;
+    addImage(canvas: HTMLCanvasElement, mode?: 'mono' | 'gray16'): this;
+    addBarcode(data: string, type?: string, hri?: 'none' | 'above' | 'below' | 'both', width?: number, height?: number): this;
+    addQRCode(data: string, type?: 'model_1' | 'model_2' | 'micro', level?: 'level_l' | 'level_m' | 'level_q' | 'level_h', width?: number): this;
+    build(): string;
+    getBuilder(): epson.ePOSBuilder;
+}
+export declare function pdfToImages(pdfFile: File, options?: {
+    scale?: number;
+    maxWidth?: number;
+}): Promise<{
+    images: string[];
+    width: number;
+    height: number;
+}[]>;
+export declare function imageToBase64(file: File): Promise<{
+    base64: string;
+    width: number;
+    height: number;
+}>;

package/dist/lib/epson-sdk-loader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Dynamic loader for Epson ePOS SDK
+ * Implements singleton pattern to avoid multiple loads
+ */
+interface LoaderState {
+    loading: boolean;
+    loaded: boolean;
+    error: Error | null;
+    promise: Promise<boolean> | null;
+}
+/**
+ * Check if SDK is already available in window
+ */
+export declare function isEpsonSDKLoaded(): boolean;
+/**
+ * Load Epson SDK dynamically (singleton pattern)
+ * Returns true if loaded successfully, false otherwise
+ */
+export declare function loadEpsonSDK(options?: {
+    sdkPath?: string;
+    timeout?: number;
+}): Promise<boolean>;
+/**
+ * Get current loader state
+ */
+export declare function getLoaderState(): Readonly<LoaderState>;
+/**
+ * Reset loader state (useful for testing)
+ */
+export declare function resetLoaderState(): void;
+/**
+ * Get Epson SDK (throws if not loaded)
+ */
+export declare function getEpsonSDK(): typeof window.epson;
+/**
+ * Initialize SDK (optional - for eager loading)
+ */
+export declare function initializeEpsonSDK(options?: {
+    sdkPath?: string;
+    timeout?: number;
+}): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+export {};

package/dist/lib/logger.d.ts

@@ -0,0 +1,29 @@
+import { LoggerConfig } from '../types';
+/**
+ * Configure the logger
+ * @param newConfig - Logger configuration options
+ */
+export declare function configureLogger(newConfig: Partial<LoggerConfig>): void;
+/**
+ * Get current logger configuration
+ */
+export declare function getLoggerConfig(): Readonly<LoggerConfig>;
+/**
+ * Log debug message (only when enabled)
+ */
+export declare function debug(message: string, ...args: unknown[]): void;
+/**
+ * Log warning message (only when enabled)
+ */
+export declare function warn(message: string, ...args: unknown[]): void;
+/**
+ * Log error message (always shown)
+ */
+export declare function error(message: string, ...args: unknown[]): void;
+export declare const logger: {
+    debug: typeof debug;
+    warn: typeof warn;
+    error: typeof error;
+    configure: typeof configureLogger;
+    getConfig: typeof getLoggerConfig;
+};

package/dist/lib/pdf-processor.d.ts

@@ -0,0 +1,37 @@
+import { PDFPageProxy } from 'pdfjs-dist';
+export interface PdfProcessingConfig {
+    /** Enable PDF processing (trimming, scaling) */
+    enabled: boolean;
+    /** Margin settings for trimming white space */
+    trimMargins?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    /** Target width for printer paper (576 for 80mm, 384 for 58mm) */
+    targetWidth?: number;
+    /** Rendering scale for quality (higher = better quality) */
+    scale?: number;
+    /** Threshold for monochrome conversion (0-255, lower = darker) */
+    monochromeThreshold?: number;
+}
+export interface ProcessedPage {
+    base64: string;
+    width: number;
+    height: number;
+    rasterBase64: string;
+    canvas: HTMLCanvasElement;
+}
+/**
+ * Default configuration for PDF processing
+ */
+export declare const DEFAULT_PDF_CONFIG: Required<PdfProcessingConfig>;
+/**
+ * Process a PDF page to canvas with optional trimming and scaling
+ */
+export declare function processPdfPage(page: PDFPageProxy, config?: PdfProcessingConfig): Promise<ProcessedPage>;
+/**
+ * Process all pages of a PDF file
+ */
+export declare function processPdfFile(file: File, config?: PdfProcessingConfig): Promise<ProcessedPage[]>;