@giveitsmaller/sdk 0.17.0 → 0.18.0

package/dist/ergonomic/image_output_routes.js

@@ -63,11 +63,11 @@ export const IMAGE_OUTPUT_ROUTES = {
     same_format: {
         avif: { honored: ['avif_speed', 'fit', 'height', 'metadata', 'output_format', 'quality', 'width'], planned: [] },
         gif: { honored: ['fit', 'height', 'metadata', 'output_format', 'quality', 'width'], planned: [] },
-        jpeg: { honored: ['fit', 'height', 'metadata', 'output_format', 'progressive', 'quality', 'width'], planned: ['lossless'] },
+        jpeg: { honored: ['fit', 'height', 'lossless', 'metadata', 'output_format', 'progressive', 'quality', 'width'], planned: [] },
         png: { honored: ['fit', 'height', 'metadata', 'optimization_level', 'output_format', 'quality', 'width'], planned: ['lossy'] },
         svg: { honored: ['metadata', 'output_format', 'quality'], planned: [] },
         tiff: { honored: ['fit', 'height', 'metadata', 'output_format', 'quality', 'width'], planned: [] },
-        webp: { honored: ['fit', 'height', 'metadata', 'output_format', 'quality', 'width'], planned: ['lossless'] },
+        webp: { honored: ['fit', 'height', 'lossless', 'metadata', 'output_format', 'quality', 'width'], planned: [] },
     },
     format_change: {
         avif: { honored: ['output_format', 'quality'], planned: [] },

package/dist/ergonomic/option_types.d.ts

@@ -98,7 +98,7 @@ export interface WatermarkOptions {
 }
 /** Resize mode (contract `fit` enum, v2.97.0). */
 export type OutputFit = 'max' | 'crop' | 'scale';
-/** Metadata policy (contract `metadata` enum, v2.97.0). `keep` is `availability:planned`. */
+/** Metadata policy (contract `metadata` enum). Both values stable since v2.102.0 (keep/strip un-parked). */
 export type OutputMetadata = 'all' | 'keep';
 /**
  * Options for the file-first `output()` image transform. The KEY SET is the
@@ -126,9 +126,9 @@ export interface OutputOptions {
     optimization_level?: number;
     /** AVIF encode speed. Honored: same_format avif only. */
     avif_speed?: number;
-    /** Metadata policy. Honored: same_format routes. (`keep` value is planned.) */
+    /** Metadata policy. Honored: same_format routes (both `all` and `keep` since v2.102.0). */
     metadata?: OutputMetadata;
-    /** JPEG/WebP lossless. PLANNED (gated unavailable). */
+    /** JPEG/WebP lossless. Honored: same_format jpeg/webp (stable since v2.101.0). */
     lossless?: boolean;
     /** Lossy PNG quantization. PLANNED (gated unavailable; licence-gated). */
     lossy?: boolean;

package/dist/generated/sdk_spec/enums.d.ts

@@ -11,6 +11,7 @@ export declare const ImageFormat: {
 export type ImageFormat = typeof ImageFormat[keyof typeof ImageFormat];
 export declare const ImageMetadataPolicy: {
     readonly All: "all";
+    readonly Keep: "keep";
 };
 export type ImageMetadataPolicy = typeof ImageMetadataPolicy[keyof typeof ImageMetadataPolicy];
 export declare const VideoCodec: {
@@ -88,6 +89,7 @@ export declare const ERGONOMIC_ENUMS: {
     };
     readonly ImageMetadataPolicy: {
         readonly All: "all";
+        readonly Keep: "keep";
     };
     readonly VideoCodec: {
         readonly H264: "h264";

package/dist/generated/sdk_spec/enums.js

@@ -12,14 +12,16 @@ export const ImageFormat = {
     Original: "original",
     Webp: "webp",
 };
-// Image metadata handling. Single value today (Option B, 2026-06-20):
-//   All = strip all EXIF/IPTC/XMP (smallest file)
-// The compress worker always strips metadata; None/Copyright/Sensitive were
-// removed — they never reached the worker (it hardcodes strip-everything), so
-// advertising metadata preservation was an over-claim. Preservation is a
-// possible future feature (would need worker support).
+// Image metadata handling (compress.image, optimiser/same_format route):
+//   All  = strip all EXIF/IPTC/XMP (default, smallest file)
+//   Keep = preserve EXIF/ICC/XMP — worker-proven on the libcaesium formats
+//          (JPEG/PNG/WebP/GIF/TIFF; lambdas PR #260, un-parked 2026-06-23).
+// Keep is NOT available for AVIF (ravif) / SVG (SVGO) — those re-encode from
+// pixels and cannot preserve metadata, so the worker rejects it there (the
+// `metadata` enum is narrowed to [all] on those groups).
 export const ImageMetadataPolicy = {
     All: "all",
+    Keep: "keep",
 };
 // Video codec. H264 = widest compatibility; H265/Av1 = better compression but slower.
 export const VideoCodec = {

package/dist/generated/sdk_spec/version.d.ts

@@ -1,3 +1,3 @@
-export declare const SDK_SPEC_VERSION: "2.0.0";
+export declare const SDK_SPEC_VERSION: "2.1.0";
 export declare const PRESET_VERSION: "1.4";
 export declare const PRESET_CONFIG_HASH: "sha256:62fbada24e33f983dacb0f717b0c9bb80824a208c3dc7f9af8523026e783543a";

package/dist/generated/sdk_spec/version.js

@@ -1,6 +1,6 @@
 // CODE GENERATED — DO NOT EDIT.
 // Source: compression_contracts/sdk-spec/ (see sdk-spec/README.md).
 // Regenerate with: scripts/generate.py.
-export const SDK_SPEC_VERSION = "2.0.0";
+export const SDK_SPEC_VERSION = "2.1.0";
 export const PRESET_VERSION = "1.4";
 export const PRESET_CONFIG_HASH = "sha256:62fbada24e33f983dacb0f717b0c9bb80824a208c3dc7f9af8523026e783543a";

package/package.json

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