@giveitsmaller/sdk 0.25.0 → 0.26.0

package/dist/file-first.d.ts

@@ -671,7 +671,7 @@ export declare const WATERMARK_CAPABILITY: {
     readonly video_watermark: {
         readonly video: {
             readonly mimes: readonly ["video/mp4", "video/webm"];
-            readonly availability: "beta";
+            readonly availability: "stable";
         };
     };
 };

package/dist/file-first.js

@@ -1372,7 +1372,7 @@ export const WATERMARK_CAPABILITY = {
         image_bmp: { mimes: ['image/bmp'], availability: 'stable' },
     },
     video_watermark: {
-        video: { mimes: ['video/mp4', 'video/webm'], availability: 'beta' },
+        video: { mimes: ['video/mp4', 'video/webm'], availability: 'stable' },
     },
 };
 const _WATERMARK_SHIPPABLE = new Set(['stable', 'beta']);

package/dist/types.d.ts

@@ -187,12 +187,25 @@ export interface WorkflowProcessingPayload {
 export interface WorkflowCreatePayload {
     jobs: JobDefinitionPayload[];
     /**
-     * Flat single-job form (with `operations`): top-level input source, exactly
-     * equivalent to `jobs: [{ source, operations }]` (contracts D0Gsri8V, v2.64.0).
-     * The spec's `oneOf` makes `jobs` and `source`+`operations` mutually exclusive;
-     * the SDK builders always emit the explicit `jobs[]` form, so these are typed
-     * optional for spec-completeness (a consumer hand-building the flat form omits
-     * `jobs`). Builder adoption of the flat form is a follow-up.
+     * Flat single-job form (with `operations`): top-level input source, described by
+     * the contract as equivalent to `jobs: [{ source, operations }]` (contracts
+     * D0Gsri8V, v2.64.0). The spec's `oneOf` makes `jobs` and `source`+`operations`
+     * mutually exclusive.
+     *
+     * 🔴 **DO NOT SEND IT. The flat form is `x-availability: planned` as of contracts
+     * v2.201.0 and the server does not accept it.** Send `jobs[]`, which is what both
+     * SDK builders always emit — these two fields are typed optional for
+     * spec-completeness only.
+     *
+     * ⚠️ **The equivalence above is the DESIGN, not observed behaviour**, and it
+     * carried no availability marker from v2.64.0 until 2026-09-10 — which per
+     * ADR-0001 §1.4 meant it read as `stable`, a GA claim about a shape nothing
+     * accepts. No shipped SDK was ever exposed; a hand-built payload was.
+     *
+     * ⚠️ **A flat request is rejected today with a generic "At least one job is
+     * required", not the `feature_not_available` 422 a `planned` shape owes you.**
+     * So do not read that message as a fault in your own payload. Tracked against
+     * `compression_api`.
      */
     source?: WorkflowSourcePayload;
     /** Flat-form operation set (with `source`); equivalent to one job's `operations`. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giveitsmaller/sdk",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Node.js SDK for the GISL (Give It Smaller) file compression and processing API",
   "license": "Apache-2.0",
   "type": "module",
@@ -31,7 +31,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@giveitsmaller/contracts": "^0.69.0"
+    "@giveitsmaller/contracts": "^0.70.0"
   },
   "devDependencies": {
     "@types/node": "^22",