@gohcltech/edge-print-client 2.0.61-develop → 2.0.70-develop

package/README.md

@@ -119,10 +119,22 @@ Each `PrinterInfo` object includes:
 | `duplex` | `boolean?` | `true` if the printer supports double-sided printing |
 | `trays` | `TrayInfo[]?` | Input trays/bins (see below) |
 | `papers` | `string[]?` | All supported paper sizes (e.g. `["Letter", "A4"]`) |
+| `mediaTypes` | `string[]?` | Stock types the driver reports (e.g. `["Plain", "Bond"]`). Absent for most printers — see below |
 | `copiesMax` | `number?` | Maximum copies the driver accepts in one job |
 | `orientations` | `string[]?` | Supported orientations (e.g. `["portrait", "landscape"]`) |
 | `virtualPrinter` | `boolean?` | `true` for Developer (virtual) printers injected by the agent |
 
+**On `mediaTypes`.** The field is usually absent. Of eleven drivers surveyed,
+eight listed no stock types at all, and a ninth listed them only under a
+vendor-private key whose values are the driver's internal codes rather than
+names you could choose from — the agent reports nothing in that case too. When
+the field is absent the agent accepts whatever stock you ask for rather than
+guessing. When it *is*
+present the strings are the driver's own and are not always self-describing, so
+read them off the target machine (the agent's Printers tab lists them) rather
+than assuming a vocabulary. Passing a value the printer does not list rejects
+with `unsupported_value`, and the error's `supported` array names the real ones.
+
 1.x agents sent `is_default`, `share_name`, `copies_max` and `virtual_printer`.
 Those spellings are still accepted on read and mapped onto the camelCase fields
 above, so nothing downstream sees the old names. **Removed in 3.0.**
@@ -223,6 +235,7 @@ Two limits worth knowing before you build on this:
 | `colorType` | `'color' \| 'grayscale' \| 'black-white'?` | Color mode |
 | `paperSize` | `string?` | Paper size from `PrinterInfo.papers` (e.g. `"Letter"`) |
 | `tray` | `string?` | Tray name from `TrayInfo.name` (e.g. `"Tray 1"`) |
+| `mediaType` | `string?` | Stock type from `PrinterInfo.mediaTypes` (e.g. `"Bond"`). Rejected for `raw`/`html` content and network targets |
 
 **`data`** — `PrintData[]`
 

package/dist/edge-print.d.ts

@@ -66,6 +66,16 @@ export interface PrintConfig {
      * Omit to use the printer's current default.
      */
     tray?: string;
+    /**
+     * Media / stock type, exactly as returned by {@link PrinterInfo.mediaTypes}
+     * (e.g. `"Plain"`, `"Bond"`, `"Thermal"`). Changes how the printer feeds and
+     * fuses the page. Omit to use the printer's current default.
+     *
+     * Not supported for `raw` or `html` content, or a network target — those
+     * paths never reach the printer's driver. Requesting it there rejects with
+     * `unsupported_for_path`.
+     */
+    mediaType?: string;
 }
 /**
  * A single unit of content to be printed.
@@ -178,6 +188,18 @@ export interface PrinterInfo {
      * Pass one of these values to {@link PrintConfig.paperSize}.
      */
     papers?: string[];
+    /**
+     * Stock types the driver reports — card stock, labels, envelopes and so on.
+     * Pass one of these values to {@link PrintConfig.mediaType}.
+     *
+     * Absent for most printers — many drivers report no stock types, and some
+     * report them only under a vendor-private key whose values are internal
+     * codes rather than choosable names. The agent reports nothing in either
+     * case and then accepts whatever is asked rather than guessing. When the
+     * field *is* present, the strings are the driver's own and may not be
+     * self-describing.
+     */
+    mediaTypes?: string[];
     /** Maximum number of copies the driver accepts in a single job. */
     copiesMax?: number;
     /** Page orientations the driver supports (e.g. `["portrait", "landscape"]`). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gohcltech/edge-print-client",
-  "version": "2.0.61-develop",
+  "version": "2.0.70-develop",
   "description": "Browser client for the Edge Printing WebSocket agent",
   "license": "MIT",
   "repository": {