@giveitsmaller/sdk 0.14.0 → 0.16.0

package/dist/generated/sdk_spec/presets.js

@@ -9,7 +9,7 @@ export const PRESETS = Object.freeze({
             "metadata": "All",
             "iccProfile": "Strip",
             "progressive": true,
-            "outputFormat": "Smallest",
+            "outputFormat": "Original",
         }),
         Balanced: Object.freeze({
             "mode": "Auto",
@@ -17,7 +17,7 @@ export const PRESETS = Object.freeze({
             "metadata": "Sensitive",
             "iccProfile": "Preserve",
             "progressive": true,
-            "outputFormat": "Auto",
+            "outputFormat": "Original",
         }),
         Quality: Object.freeze({
             "mode": "Lossless",
@@ -48,17 +48,14 @@ export const PRESETS = Object.freeze({
         Size: Object.freeze({
             "crf": 30,
             "preset": "Slow",
-            "audioBitrate": "_96",
         }),
         Balanced: Object.freeze({
             "crf": 23,
             "preset": "Medium",
-            "audioBitrate": "_128",
         }),
         Quality: Object.freeze({
             "crf": 18,
             "preset": "Slow",
-            "audioBitrate": "_192",
         }),
     }),
     "document_pdf_compress": Object.freeze({

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

@@ -1,3 +1,3 @@
-export declare const SDK_SPEC_VERSION: "1.5.0";
-export declare const PRESET_VERSION: "1.0";
-export declare const PRESET_CONFIG_HASH: "sha256:3791bd2d0cd474c5029707f6e50480bf49be33899f7fc5c1a4e77edb136f6e95";
+export declare const SDK_SPEC_VERSION: "1.7.0";
+export declare const PRESET_VERSION: "1.2";
+export declare const PRESET_CONFIG_HASH: "sha256:ef4d66a81920cec353633d788061a03f7c8891d622908c1bfca326679725e72b";

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 = "1.5.0";
-export const PRESET_VERSION = "1.0";
-export const PRESET_CONFIG_HASH = "sha256:3791bd2d0cd474c5029707f6e50480bf49be33899f7fc5c1a4e77edb136f6e95";
+export const SDK_SPEC_VERSION = "1.7.0";
+export const PRESET_VERSION = "1.2";
+export const PRESET_CONFIG_HASH = "sha256:ef4d66a81920cec353633d788061a03f7c8891d622908c1bfca326679725e72b";

package/dist/handle.js

@@ -34,7 +34,7 @@
  */
 import { GislConfigError, GislNetworkError, GislResultNotReadyError, GislTimeoutError, SseEndedWithoutTerminal, } from './errors.js';
 import { _consumeSseToTerminal, _pollToTerminal, _parseMaxWait, } from './builder.js';
-import { projectDownloadsToRunResult, projectMultiJobToRunResult, isFanoutStatus, isMergeStatus, isArchiveStatus, } from './file-first.js';
+import { projectDownloadsToRunResult, projectMultiJobToRunResult, isFanoutStatus, isMergeStatus, isArchiveStatus, isWatermarkStatus, } from './file-first.js';
 import { LazyHttpDownloader } from './lazy-downloader.js';
 /**
  * The terminal workflow states. A status response in any of these states
@@ -237,6 +237,14 @@ export class Handle {
             const archiveDownloads = jobDownloads.filter((d) => d.ref === 'archive');
             return projectDownloadsToRunResult(this.workflowId, finalStatus, archiveDownloads, null, downloader);
         }
+        // A fluent `file(...).watermark(overlay)` — project ONLY the watermark
+        // output, filtering the `src_*` (base/overlay) passthrough plumbing. Matches
+        // WatermarkedRecipe.run()'s `ref === 'watermark'` filter so a
+        // submitted/reattached watermark handle never surfaces the raw inputs.
+        if (isWatermarkStatus(finalStatus)) {
+            const watermarkDownloads = jobDownloads.filter((d) => d.ref === 'watermark');
+            return projectDownloadsToRunResult(this.workflowId, finalStatus, watermarkDownloads, null, downloader);
+        }
         return projectDownloadsToRunResult(this.workflowId, finalStatus, jobDownloads, this.#key, downloader);
     }
     /**

package/dist/index.core.d.ts

@@ -13,6 +13,8 @@ export { FilesRecipe } from './file-first.js';
 export { MergedRecipe } from './file-first.js';
 export { ArchivedRecipe } from './file-first.js';
 export type { ArchiveRecipeOptions } from './file-first.js';
+export { WatermarkedRecipe } from './file-first.js';
+export type { WatermarkWireOp } from './file-first.js';
 export { Handle, StatusSnapshot } from './handle.js';
 export { gisl, create } from './gisl.js';
 export type { GislCreateOptions, Environment, ErgonomicClient } from './gisl.js';

package/dist/index.core.js

@@ -48,6 +48,11 @@ export { MergedRecipe } from './file-first.js';
 // File-first N→1 bundle (FF3b) — `client.files([...]).archive(opts?)` returns a
 // terminal ArchivedRecipe (zip / tar.gz; no post-bundle chain), then run()/submit().
 export { ArchivedRecipe } from './file-first.js';
+// File-first multi-input watermark (FF4a / Z7zTr789) — `client.file(base)
+// .watermark(overlay, opts)` returns a single-output WatermarkedRecipe you chain
+// post-watermark ops on, then run()/submit(). Routes image_watermark / video_watermark
+// by base media; gates planned/unsupported bases locally pre-upload.
+export { WatermarkedRecipe } from './file-first.js';
 // `HttpDownloader` (Node streaming downloader) is re-exported from the Node-only
 // entry `index.ts`, NOT here — it statically imports node:fs/node:stream.
 // `projectDownloadsToRunResult` is intentionally NOT re-exported here — it is an

package/dist/types.d.ts

@@ -279,6 +279,20 @@ export interface PreflightClipError {
     fileId: string;
     error: unknown;
 }
+/**
+ * Read-time options for a single anonymous-readable workflow query.
+ *
+ * Carries the one-time capability token returned by an anonymous (null-owner)
+ * workflow create (`WorkflowCreateResponse.cap`). Pass it on status / downloads
+ * / events reads so a session-less caller can read its own workflow; the SDK
+ * sends it as the `X-Workflow-Capability` header. Omit it for authenticated
+ * reads — the session authorizes those. A wrong or missing token on a
+ * null-owner workflow returns 404 (deliberately no existence oracle).
+ */
+export interface ReadCapabilityOptions {
+    /** Anonymous-workflow capability token (the `cap` from workflow-create). */
+    capability?: string;
+}
 export interface WaitOptions {
     /** Poll interval in milliseconds (default: 2000) */
     intervalMs?: number;
@@ -286,6 +300,13 @@ export interface WaitOptions {
     timeoutMs?: number;
     /** Called after each poll with current status */
     onPoll?: (status: string) => void;
+    /**
+     * Anonymous-workflow capability token (the `cap` from workflow-create),
+     * forwarded to each underlying status poll as the `X-Workflow-Capability`
+     * header. Required to poll a null-owner workflow without a session; omit
+     * for authenticated polling.
+     */
+    capability?: string;
 }
 export interface ProbeWaitOptions {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giveitsmaller/sdk",
-  "version": "0.14.0",
+  "version": "0.16.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.18.0"
+    "@giveitsmaller/contracts": "^0.21.0"
   },
   "devDependencies": {
     "@types/node": "^22",