[printer] New typings for module "printer" (#47625)

* Add types for printer

* Update types/printer/index.d.ts

Co-authored-by: Piotr Błażejewicz (Peter Blazejewicz) <peterblazejewicz@users.noreply.github.com>

* Remove namespace declaration

Co-authored-by: Piotr Błażejewicz (Peter Blazejewicz) <peterblazejewicz@users.noreply.github.com>

types/printer/index.d.ts

@@ -0,0 +1,63 @@
+// Type definitions for printer 0.4
+// Project: http://github.com/tojocky/node-printer
+// Definitions by: Christos Panagiotakopoulos <https://github.com/chrispanag>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+/// <reference types="node" />
+
+export function getPrinters(): PrinterDetails[];
+export function getPrinter(printerName: string): PrinterDetails;
+export function getPrinterDriverOptions(printerName: string): PrinterDriverOptions;
+export function getSelectedPaperSize(printerName: string): string;
+export function getDefaultPrinterName(): string | undefined;
+export function printDirect(options: PrintDirectOptions): void;
+export function printFile(options: PrintFileOptions): void;
+export function getSupportedPrintFormats(): string[];
+export function getJob(printerName: string, jobId: number): JobDetails;
+export function setJob(printerName: string, jobId: number, command: 'CANCEL' | string): void;
+export function getSupportedJobCommands(): string[];
+
+export interface PrintDirectOptions {
+    data: string | Buffer;
+    printer?: string;
+    type?: 'RAW' | 'TEXT' | 'PDF' | 'JPEG' | 'POSTSCRIPT' | 'COMMAND' | 'AUTO';
+    options?: { [key: string]: string };
+    success?: PrintOnSuccessFunction;
+    error?: PrintOnErrorFunction;
+}
+
+export interface PrintFileOptions {
+    filename: string;
+    printer?: string;
+    success?: PrintOnSuccessFunction;
+    error?: PrintOnErrorFunction;
+}
+
+export type PrintOnSuccessFunction = (jobId: string) => any;
+export type PrintOnErrorFunction = (err: Error) => any;
+
+export interface PrinterDetails {
+    name: string;
+    isDefault: boolean;
+    options: { [key: string]: string; };
+}
+
+export interface PrinterDriverOptions {
+    [key: string]: { [key: string]: boolean; };
+}
+
+export interface JobDetails {
+    id: number;
+    name: string;
+    printerName: string;
+    user: string;
+    format: string;
+    priority: number;
+    size: number;
+    status: JobStatus[];
+    completedTime: Date;
+    creationTime: Date;
+    processingTime: Date;
+}
+
+export type JobStatus = 'PAUSED' | 'PRINTING' | 'PRINTED' | 'CANCELLED' | 'PENDING' | 'ABORTED';

types/printer/printer-tests.ts

@@ -0,0 +1,17 @@
+import printer = require("printer");
+
+printer.getDefaultPrinterName(); // $ExpectType string | undefined
+printer.getJob("test", 5); // $ExpectType JobDetails
+printer.getPrinter("printerName"); // $ExpectType PrinterDetails
+printer.getPrinterDriverOptions("printerName"); // $ExpectType PrinterDriverOptions
+printer.getPrinters(); // $ExpectType PrinterDetails[]
+printer.getSelectedPaperSize("printerName"); // $ExpectType string
+printer.getSupportedJobCommands(); // $ExpectType string[]
+printer.getSupportedPrintFormats(); // $ExpectType string[]
+printer.printDirect({
+    data: 'test'
+});
+printer.printFile({
+    filename: 'test'
+});
+printer.setJob("printerName", 5, "CANCEL"); // $ExpectType void

types/printer/tsconfig.json

@@ -0,0 +1,23 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": [
+            "es6"
+        ],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictFunctionTypes": true,
+        "strictNullChecks": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "printer-tests.ts"
+    ]
+}

types/printer/tslint.json

@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }