@giveitsmaller/sdk 0.12.0 → 0.12.1

package/dist/file-first.d.ts

@@ -335,8 +335,9 @@ export declare class Recipe {
      */
     compress(optimize?: OptimizeFor, options?: Record<string, unknown>): Recipe;
     /**
-     * Change format. `format` is lowered verbatim to the `format` wire option;
-     * `options` carries any additional per-op convert options.
+     * Change format. The `format` shorthand lowers to the `output_format` wire
+     * option (the convert op's wire key per the contract); `options` carries any
+     * additional per-op convert options.
      */
     convert(format: string, options?: Record<string, unknown>): Recipe;
     /**

package/dist/file-first.js

@@ -436,13 +436,19 @@ export class Recipe {
         });
     }
     /**
-     * Change format. `format` is lowered verbatim to the `format` wire option;
-     * `options` carries any additional per-op convert options.
+     * Change format. The `format` shorthand lowers to the `output_format` wire
+     * option (the convert op's wire key per the contract); `options` carries any
+     * additional per-op convert options.
      */
     convert(format, options = {}) {
-        // Spread options FIRST so the explicit `format` argument is authoritative —
-        // a `format` key in the bag must NOT silently override the call's format.
-        return this.withStep({ opType: 'convert', options: { ...options, format } });
+        // The convert op's wire key is `output_format` (contract: convert.yaml,
+        // required, all media), NOT `format`. Spread options FIRST so the explicit
+        // shorthand wins over an `output_format` key in the bag.
+        // The shorthand owns the format → a stray legacy `format` key in the bag is
+        // not a valid convert option; drop it so the wire never carries both keys.
+        const rest = { ...options };
+        delete rest.format;
+        return this.withStep({ opType: 'convert', options: { ...rest, output_format: format } });
     }
     /**
      * Generate a preview. Width and/or height in pixels; any additional per-op
@@ -1053,9 +1059,14 @@ export class MergedRecipe {
     }
     /** Change the merged output's format. See {@link Recipe.convert}. */
     convert(format, options = {}) {
-        // Spread options FIRST so the explicit `format` argument is authoritative —
-        // a `format` key in the bag must NOT silently override the call's format.
-        return this.withStep({ opType: 'convert', options: { ...options, format } });
+        // The convert op's wire key is `output_format` (contract: convert.yaml,
+        // required, all media), NOT `format`. Spread options FIRST so the explicit
+        // shorthand wins over an `output_format` key in the bag.
+        // The shorthand owns the format → a stray legacy `format` key in the bag is
+        // not a valid convert option; drop it so the wire never carries both keys.
+        const rest = { ...options };
+        delete rest.format;
+        return this.withStep({ opType: 'convert', options: { ...rest, output_format: format } });
     }
     /** Thumbnail the merged output. Omitted dimensions are dropped from the wire options. */
     thumbnail(options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giveitsmaller/sdk",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Node.js SDK for the GISL (Give It Smaller) file compression and processing API",
   "license": "MIT",
   "type": "module",