@types/chrome 0.0.278 → 0.0.279

chrome/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for chrome (http://developer.chrome.com/e
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
 
 ### Additional Details
- * Last updated: Mon, 14 Oct 2024 18:09:31 GMT
+ * Last updated: Mon, 21 Oct 2024 17:07:38 GMT
  * Dependencies: [@types/filesystem](https://npmjs.com/package/@types/filesystem), [@types/har-format](https://npmjs.com/package/@types/har-format)
 
 # Credits

chrome/index.d.ts

@@ -7079,6 +7079,136 @@ declare namespace chrome.printing {
     export const onJobStatusChanged: chrome.events.Event<(jobId: string, status: JobStatus) => void>;
 }
 
+////////////////////
+// Printing Metrics
+////////////////////
+/**
+ * Use the chrome.printingMetrics API to fetch data about printing usage.
+ *
+ * Permissions: "printingMetrics"
+ *
+ * Note: This API is only for extensions pre-installed by policy.
+ * @platform ChromeOS only
+ * @since Chrome 79
+ */
+declare namespace chrome.printingMetrics {
+    export enum ColorMode {
+        /** Specifies that black and white mode was used. */
+        BLACK_AND_WHITE = "BLACK_AND_WHITE",
+        /** Specifies that color mode was used. */
+        COLOR = "COLOR",
+    }
+
+    export enum DuplexMode {
+        /** Specifies that one-sided printing was used. */
+        ONE_SIDED = "ONE_SIDED",
+        /** Specifies that two-sided printing was used, flipping on long edge. */
+        TWO_SIDED_LONG_EDGE = "TWO_SIDED_LONG_EDGE",
+        /** Specifies that two-sided printing was used, flipping on short edge. */
+        TWO_SIDED_SHORT_EDGE = "TWO_SIDED_SHORT_EDGE",
+    }
+
+    export interface MediaSize {
+        /** Height (in micrometers) of the media used for printing. */
+        height: number;
+        /**
+         * Vendor-provided ID, e.g. "iso_a3_297x420mm" or "na_index-3x5_3x5in".
+         * Possible values are values of "media" IPP attribute and can be found on [IANA page](https://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtml).
+         */
+        vendorId: string;
+        /** Width (in micrometers) of the media used for printing. */
+        width: number;
+    }
+
+    export interface Printer {
+        /** Displayed name of the printer. */
+        name: string;
+        /** The source of the printer. */
+        source: PrinterSource;
+        /** The full path for the printer. Contains protocol, hostname, port, and queue. */
+        uri: string;
+    }
+
+    /** The source of the printer. */
+    export enum PrinterSource {
+        /** Specifies that the printer was added by user. */
+        USER = "USER",
+        /** Specifies that the printer was added via policy. */
+        POLICY = "POLICY",
+    }
+
+    export interface PrintJobInfo {
+        /** The job completion time (in milliseconds past the Unix epoch). */
+        completionTime: number;
+        /** The job creation time (in milliseconds past the Unix epoch). */
+        creationTime: number;
+        /** The ID of the job. */
+        id: string;
+        /** The number of pages in the document. */
+        numberOfPages: number;
+        /** The info about the printer which printed the document. */
+        printer: Printer;
+        /**
+         * The status of the printer.
+         * @since Chrome 85
+         */
+        printer_status: chrome.printing.PrinterStatus;
+        /** The settings of the print job. */
+        settings: PrintSettings;
+        /** Source showing who initiated the print job. */
+        source: PrintJobSource;
+        /** ID of source. Null if source is PRINT_PREVIEW or ANDROID_APP. */
+        sourceId: string | null;
+        /** The final status of the job. */
+        status: PrintJobStatus;
+        /** The title of the document which was printed. */
+        title: string;
+    }
+
+    /** The source of the print job. */
+    export enum PrintJobSource {
+        /** Specifies that the job was created from the Print Preview page initiated by the user. */
+        PRINT_PREVIEW = "PRINT_PREVIEW",
+        /** Specifies that the job was created from an Android App. */
+        ANDROID_APP = "ANDROID_APP",
+        /** Specifies that the job was created by extension via Chrome API. */
+        EXTENSION = "EXTENSION",
+        /** Specifies that the job was created by an Isolated Web App via API. */
+        ISOLATED_WEB_APP = "ISOLATED_WEB_APP",
+    }
+
+    /** Specifies the final status of the print job. */
+    export enum PrintJobStatus {
+        /** Specifies that the print job was interrupted due to some error. */
+        FAILED = "FAILED",
+        /** Specifies that the print job was canceled by the user or via API. */
+        CANCELED = "CANCELED",
+        /** Specifies that the print job was printed without any errors. */
+        PRINTED = "PRINTED",
+    }
+
+    export interface PrintSettings {
+        /** The requested color mode. */
+        color: ColorMode;
+        /** The requested number of copies. */
+        copies: number;
+        /** The requested duplex mode. */
+        duplex: DuplexMode;
+        /** The requested media size. */
+        mediaSize: MediaSize;
+    }
+
+    /**
+     * Returns the list of the finished print jobs.
+     * Can return its result via Promise in Manifest V3 or later since Chrome 96.
+     */
+    export function getPrintJobs(): Promise<PrintJobInfo[]>;
+    export function getPrintJobs(callback: (jobs: PrintJobInfo[]) => void): void;
+
+    /** Event fired when the print job is finished. This includes any of termination statuses: FAILED, CANCELED and PRINTED. */
+    export const onPrintJobFinished: chrome.events.Event<(jobInfo: PrintJobInfo) => void>;
+}
+
 ////////////////////
 // Privacy
 ////////////////////

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.0.278",
+    "version": "0.0.279",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -93,6 +93,6 @@
         "@types/filesystem": "*",
         "@types/har-format": "*"
     },
-    "typesPublisherContentHash": "887e3fa4cc8ffda1e14db7ffcbf365d014000b05fae878791a3ea1b2adbe8a0c",
+    "typesPublisherContentHash": "62a9f28fa3e7418551081670e460c63ed76a152fb2be41dd694950f4d3cd006c",
     "typeScriptVersion": "4.8"
 }