Introduce concept of provisional destinations to print preview

chrome/browser/resources/print_preview/native_layer.js

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 cr.exportPath('print_preview');
 
 /**
  * @typedef {{selectSaveAsPdfDestination: boolean,
  *            layoutSettings.portrait: boolean,
  *            pageRange: string,
@@ skipping 49 matching lines @@
         this.onPrivetCapabilitiesSet_.bind(this);
     global.onPrivetPrintFailed = this.onPrivetPrintFailed_.bind(this);
     global.onExtensionPrintersAdded =
         this.onExtensionPrintersAdded_.bind(this);
     global.onExtensionCapabilitiesSet =
         this.onExtensionCapabilitiesSet_.bind(this);
     global.onEnableManipulateSettingsForTest =
         this.onEnableManipulateSettingsForTest_.bind(this);
     global.printPresetOptionsFromDocument =
         this.onPrintPresetOptionsFromDocument_.bind(this);
+    global.onProvisionalPrinterResolved =
+        this.onProvisionalDestinationResolved_.bind(this);
+    global.failedToResolveProvisionalPrinter =
+        this.failedToResolveProvisionalDestination_.bind(this);
   };
 
   /**
    * Event types dispatched from the Chromium native layer.
    * @enum {string}
    * @const
    */
   NativeLayer.EventType = {
     ACCESS_TOKEN_READY: 'print_preview.NativeLayer.ACCESS_TOKEN_READY',
     CAPABILITIES_SET: 'print_preview.NativeLayer.CAPABILITIES_SET',
@@ skipping 19 matching lines @@
     SETTINGS_INVALID: 'print_preview.NativeLayer.SETTINGS_INVALID',
     PRIVET_PRINTER_CHANGED: 'print_preview.NativeLayer.PRIVET_PRINTER_CHANGED',
     PRIVET_CAPABILITIES_SET:
         'print_preview.NativeLayer.PRIVET_CAPABILITIES_SET',
     PRIVET_PRINT_FAILED: 'print_preview.NativeLayer.PRIVET_PRINT_FAILED',
     EXTENSION_PRINTERS_ADDED:
         'print_preview.NativeLayer.EXTENSION_PRINTERS_ADDED',
     EXTENSION_CAPABILITIES_SET:
         'print_preview.NativeLayer.EXTENSION_CAPABILITIES_SET',
     PRINT_PRESET_OPTIONS: 'print_preview.NativeLayer.PRINT_PRESET_OPTIONS',
+    PROVISIONAL_DESTINATION_RESOLVED:
+        'print_preview.NativeLayer.PROVISIONAL_DESTINATION_RESOLVED'
   };
 
   /**
    * Constant values matching printing::DuplexMode enum.
    * @enum {number}
    */
   NativeLayer.DuplexMode = {
     SIMPLEX: 0,
     LONG_EDGE: 1,
     UNKNOWN_DUPLEX_MODE: -1
@@ skipping 88 matching lines @@
     /**
      * Requests the destination's printing capabilities. A CAPABILITIES_SET
      * event will be dispatched in response.
      * @param {string} destinationId ID of the destination.
      */
     startGetLocalDestinationCapabilities: function(destinationId) {
       chrome.send('getPrinterCapabilities', [destinationId]);
     },
 
     /**
+     * Requests Chrome to resolve provisional extension destination by granting
+     * the provider extension access to the printer. Chrome will respond with
+     * the resolved destination properties by calling
+     * {@code onProvisionalPrinterResolved}, or in case of an error
+     * {@code failedToResolveProvisionalPrinter}
+     * @param {string} provisionalDestinationId
+     */
+    grantExtensionPrinterAccess: function(provisionalDestinationId) {
+      chrome.send('grantExtensionPrinterAccess', [provisionalDestinationId]);
+    },
+
+    /**
      * @param {!print_preview.Destination} destination Destination to print to.
      * @param {!print_preview.ticket_items.Color} color Color ticket item.
      * @return {number} Native layer color model.
      * @private
      */
     getNativeColorModel_: function(destination, color) {
       // For non-local printers native color model is ignored anyway.
       var option = destination.isLocal ? color.getSelectedOption() : null;
       var nativeColorModel = parseInt(option ? option.vendor_id : null, 10);
       if (isNaN(nativeColorModel)) {
@@ skipping 536 matching lines @@
             new Event(NativeLayer.EventType.PRIVET_PRINT_FAILED);
       privetPrintFailedEvent.httpError = http_error;
       this.dispatchEvent(privetPrintFailedEvent);
     },
 
     /**
      * @param {Array<!{extensionId: string,
      *                 extensionName: string,
      *                 id: string,
      *                 name: string,
-     *                 description: (string|undefined)}>} printers The list
+     *                 description: (string|undefined),
+     *                 provisional: (boolean|undefined)}>} printers The list
      *     containing information about printers added by an extension.
      * @param {boolean} done Whether this is the final list of extension
      *     managed printers.
      */
     onExtensionPrintersAdded_: function(printers, done) {
       var event = new Event(NativeLayer.EventType.EXTENSION_PRINTERS_ADDED);
       event.printers = printers;
       event.done = done;
       this.dispatchEvent(event);
     },
 
     /**
      * Called when an extension responds to a request for an extension printer
      * capabilities.
      * @param {string} printerId The printer's ID.
      * @param {!Object} capabilities The reported printer capabilities.
      */
     onExtensionCapabilitiesSet_: function(printerId,
                                           capabilities) {
       var event = new Event(NativeLayer.EventType.EXTENSION_CAPABILITIES_SET);
       event.printerId = printerId;
       event.capabilities = capabilities;
       this.dispatchEvent(event);
     },
 
+    /**
+     * Called when Chrome reports that attempt to resolve a provisional
+     * destination failed.
+     * @param {string} destinationId The provisional destination ID.
+     * @private
+     */
+    failedToResolveProvisionalDestination_: function(destinationId) {
+      var evt = new Event(
+          NativeLayer.EventType.PROVISIONAL_DESTINATION_RESOLVED);
+      evt.provisionalId = destinationId;
+      evt.destination = null;
+      this.dispatchEvent(evt);
+    },
+
+    /**
+     * Called when Chrome reports that a provisional destination has been
+     * successfully resolved.
+     * Currently used only for extension provided destinations.
+     * @param {string} provisionalDestinationId The provisional destination id.
+     * @param {!{extensionId: string,
+     *           extensionName: string,
+     *           id: string,
+     *           name: string,
+     *           description: (string|undefined)}} destinationInfo The resolved
+     *     destination info.
+     * @private
+     */
+    onProvisionalDestinationResolved_: function(provisionalDestinationId,
+                                                destinationInfo) {
+      var evt = new Event(
+          NativeLayer.EventType.PROVISIONAL_DESTINATION_RESOLVED);
+      evt.provisionalId = provisionalDestinationId;
+      evt.destination = destinationInfo;
+      this.dispatchEvent(evt);
+    },
+
    /**
      * Allows for onManipulateSettings to be called
      * from the native layer.
      * @private
      */
     onEnableManipulateSettingsForTest_: function() {
       global.onManipulateSettingsForTest =
           this.onManipulateSettingsForTest_.bind(this);
     },
 
@@ skipping 224 matching lines @@
       return this.serializedAppStateStr_;
     }
   };
 
   // Export
   return {
     NativeInitialSettings: NativeInitialSettings,
     NativeLayer: NativeLayer
   };
 });