@giveitsmaller/sdk 0.19.0 → 0.21.0

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

@@ -63,20 +63,6 @@ export declare const AudioSampleRate: {
     readonly _48000: 48000;
 };
 export type AudioSampleRate = typeof AudioSampleRate[keyof typeof AudioSampleRate];
-export declare const PdfProfile: {
-    readonly Screen: "screen";
-    readonly Ebook: "ebook";
-    readonly Printer: "printer";
-    readonly Prepress: "prepress";
-};
-export type PdfProfile = typeof PdfProfile[keyof typeof PdfProfile];
-export declare const PdfColorspace: {
-    readonly Unchanged: "unchanged";
-    readonly Rgb: "rgb";
-    readonly Cmyk: "cmyk";
-    readonly Grayscale: "grayscale";
-};
-export type PdfColorspace = typeof PdfColorspace[keyof typeof PdfColorspace];
 /** Catalog of every ergonomic enum (canonicalName → wire). */
 export declare const ERGONOMIC_ENUMS: {
     readonly OptimizeFor: {
@@ -135,16 +121,4 @@ export declare const ERGONOMIC_ENUMS: {
         readonly _44100: 44100;
         readonly _48000: 48000;
     };
-    readonly PdfProfile: {
-        readonly Screen: "screen";
-        readonly Ebook: "ebook";
-        readonly Printer: "printer";
-        readonly Prepress: "prepress";
-    };
-    readonly PdfColorspace: {
-        readonly Unchanged: "unchanged";
-        readonly Rgb: "rgb";
-        readonly Cmyk: "cmyk";
-        readonly Grayscale: "grayscale";
-    };
 };

package/dist/generated/sdk_spec/enums.js

@@ -77,20 +77,6 @@ export const AudioSampleRate = {
     _44100: 44100,
     _48000: 48000,
 };
-// PDF Ghostscript preset. Screen = smallest; Ebook = mid; Printer = 300dpi; Prepress = print-production.
-export const PdfProfile = {
-    Screen: "screen",
-    Ebook: "ebook",
-    Printer: "printer",
-    Prepress: "prepress",
-};
-// PDF output color space.
-export const PdfColorspace = {
-    Unchanged: "unchanged",
-    Rgb: "rgb",
-    Cmyk: "cmyk",
-    Grayscale: "grayscale",
-};
 /** Catalog of every ergonomic enum (canonicalName → wire). */
 export const ERGONOMIC_ENUMS = {
     OptimizeFor,
@@ -102,6 +88,4 @@ export const ERGONOMIC_ENUMS = {
     AudioBitrate,
     AudioCodec,
     AudioSampleRate,
-    PdfProfile,
-    PdfColorspace,
 };

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

@@ -1,4 +1,4 @@
-export type ErrorCode = "missing_credentials" | "feature_requires_auth" | "undeclared_asset" | "unused_asset" | "per_input_options_not_supported" | "chain_cardinality_mismatch" | "multipart_part_invalid" | "multipart_part_count_exceeded" | "timeout" | "aborted" | "validation_failed" | "validation_error" | "cyclic_workflow_edges" | "workflow_edge_references_unknown_job" | "reserved_job_id_pattern" | "cyclic_job_output_source_graph" | "auth_failed" | "feature_tier_restricted" | "tier_restriction" | "multipart_session_ownership" | "multipart_session_auth_required" | "multipart_session_not_found" | "upload_not_found" | "workflow_expired" | "balance_exhausted" | "feature_not_available" | "upload_size_exceeds_tier" | "upload_duration_exceeds_tier" | "probe_pending" | "requires_reencode" | "invalid_options" | "invalid_combination" | "missing_dependency" | "unsupported_value" | "type_mismatch" | "upload_failed" | "workflow_failed";
+export type ErrorCode = "missing_credentials" | "feature_requires_auth" | "undeclared_asset" | "unused_asset" | "per_input_options_not_supported" | "chain_cardinality_mismatch" | "multipart_part_invalid" | "multipart_part_count_exceeded" | "timeout" | "aborted" | "validation_failed" | "validation_error" | "cyclic_workflow_edges" | "workflow_edge_references_unknown_job" | "reserved_job_id_pattern" | "cyclic_job_output_source_graph" | "auth_failed" | "feature_tier_restricted" | "tier_restriction" | "multipart_session_ownership" | "multipart_session_auth_required" | "multipart_session_not_found" | "upload_not_found" | "workflow_expired" | "balance_exhausted" | "feature_not_available" | "upload_size_exceeds_tier" | "upload_duration_exceeds_tier" | "probe_pending" | "requires_reencode" | "invalid_options" | "invalid_combination" | "missing_dependency" | "unsupported_value" | "type_mismatch" | "image_dimensions_too_large" | "upload_failed" | "workflow_failed";
 export type ErrorCategory = 'api' | 'config' | 'network' | 'auth' | 'validation' | 'chain';
 export type ErrorStatus = 'wired' | 'planned';
 export interface ErrorEntry {

package/dist/generated/sdk_spec/errors.js

@@ -467,6 +467,17 @@ export const ERROR_CODES = Object.freeze({
             "actual": "string",
         }),
     }),
+    "image_dimensions_too_large": Object.freeze({
+        code: "image_dimensions_too_large",
+        category: "api",
+        source: "ErrorEnvelope.error",
+        status: "wired",
+        httpStatus: 413,
+        retryable: false,
+        sdkClass: "GislUploadCapExceededError",
+        description: "413 — POST /api/uploads rejected a decodable raster image whose pixel area (width × height) exceeds the configured ceiling (UPLOAD_MAX_IMAGE_PIXELS, default 16 MP), read from the file header before decode (I0Rqj4jo). Wire `IMAGE_DIMENSIONS_TOO_LARGE`; flat ErrorEnvelope (no details[]). A pixel-dimension member of the upload-cap family — GislUploadCapExceededError, alongside the size/duration caps — matching the SDKs' existing status-based 413 dispatch (NOT GislValidationError, which is the structured-422 class). Retry only after downscaling the input.",
+        metadataSchema: Object.freeze({}),
+    }),
     "upload_failed": Object.freeze({
         code: "upload_failed",
         category: "network",
@@ -509,6 +520,7 @@ export const ERROR_CATEGORIES = Object.freeze({
         "upload_duration_exceeds_tier",
         "probe_pending",
         "requires_reencode",
+        "image_dimensions_too_large",
         "workflow_failed",
     ]),
     config: Object.freeze([

package/dist/generated/sdk_spec/presets.js

@@ -50,20 +50,6 @@ export const PRESETS = Object.freeze({
             "preset": "Slow",
         }),
     }),
-    "document_pdf_compress": Object.freeze({
-        Size: Object.freeze({
-            "profile": "Screen",
-            "grayscale": true,
-        }),
-        Balanced: Object.freeze({
-            "profile": "Ebook",
-            "grayscale": false,
-        }),
-        Quality: Object.freeze({
-            "profile": "Printer",
-            "grayscale": false,
-        }),
-    }),
     "document_office_compress": Object.freeze({
         Size: Object.freeze({
             "stripMacros": true,

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

@@ -1,3 +1,3 @@
-export declare const SDK_SPEC_VERSION: "2.2.0";
+export declare const SDK_SPEC_VERSION: "2.3.0";
 export declare const PRESET_VERSION: "1.6";
-export declare const PRESET_CONFIG_HASH: "sha256:0fe215aede1da13430380384c58226d074c3b8344c091efc53e097c2930a34f7";
+export declare const PRESET_CONFIG_HASH: "sha256:354814f7906f85be6a6ca5ede6c0722c83cdc058fd658a9bb2b0996520466c6d";

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.2.0";
+export const SDK_SPEC_VERSION = "2.3.0";
 export const PRESET_VERSION = "1.6";
-export const PRESET_CONFIG_HASH = "sha256:0fe215aede1da13430380384c58226d074c3b8344c091efc53e097c2930a34f7";
+export const PRESET_CONFIG_HASH = "sha256:354814f7906f85be6a6ca5ede6c0722c83cdc058fd658a9bb2b0996520466c6d";

package/dist/gisl.d.ts

@@ -19,12 +19,13 @@
 import { GislClient } from './client.js';
 import { GislConfigError, GislFeatureRequiresAuthError, GislMissingCredentialsError } from './errors.js';
 import { type ResolveCredentialsOptions, type ResolveEndpointOptions } from './credentials.js';
-import type { CreditsUsageOptions, GislClientConfig } from './types.js';
-import type { AccountLimits, CreditsBalanceResponse, CreditsUsageResponse } from '@giveitsmaller/contracts/openapi';
+import type { CreditsUsageOptions, GislClientConfig, CapabilitiesSnapshot } from './types.js';
+import type { AccountLimits, CreditsBalanceResponse, CreditsUsageResponse, OperationCapability, OperationType } from '@giveitsmaller/contracts/openapi';
 import { OperationBuilder } from './builder.js';
+import type { ConvertOptions, ThumbnailOptions } from './ergonomic/option_types.js';
 import { MergeBuilder, type Asset, type MergeOptions } from './merge.js';
 import { PresetDefaults } from './ergonomic/presets/index.js';
-import { Recipe, FilesRecipe, type FileInput } from './file-first.js';
+import { Recipe, FilesRecipe, BatchRecipe, type FileInput } from './file-first.js';
 import { Handle } from './handle.js';
 /**
  * Operations that may be invoked on a `gisl.anonymous()` client without
@@ -61,6 +62,21 @@ export interface GislCreateOptions extends ResolveCredentialsOptions, ResolveEnd
  * legitimately have no apiKey at construction time.
  */
 export declare function create(opts?: GislCreateOptions): Promise<ErgonomicClient>;
+/**
+ * Operation types that need MORE THAN ONE input source, so they cannot be
+ * driven through the single-input {@link ErgonomicClient.operation} escape
+ * hatch — each has a dedicated multi-input builder (`merge(...)`,
+ * `files(...).archive(...)`, `file(a).watermark(b)`). Excluded from
+ * `operation()`'s op-type autocomplete.
+ */
+export type MultiInputOperationType = 'merge' | 'archive' | 'image_watermark' | 'video_watermark' | 'audio_overlay' | 'audio_to_video';
+/**
+ * Op types reachable via {@link ErgonomicClient.operation}: every
+ * {@link OperationType} except the {@link MultiInputOperationType} ones, widened
+ * with `(string & {})` so a genuinely-unknown (not-yet-in-contract) op type is
+ * still accepted while known single-input ops keep autocomplete.
+ */
+export type SingleInputOperationType = Exclude<OperationType, MultiInputOperationType> | (string & {});
 /**
  * The ergonomic-client surface: `GislClient` (verbatim low-level API)
  * plus three ergonomic op-builder factories. Intersection type — at
@@ -91,6 +107,20 @@ export type ErgonomicClient = GislClient & {
      * returns a {@link Handle} whose `wait()`/`result()` partition per input.
      */
     files(inputs: ReadonlyArray<string | Blob | FileInput>): FilesRecipe;
+    /**
+     * Keyed multi-recipe batch entry point (FF7). Run N DISTINCT single-input
+     * keyed {@link Recipe}s as ONE workflow — build each via
+     * `client.file(input, key).<op>(...)` with a UNIQUE key, then
+     * `client.batch([r1, r2, …]).run()`. The partitioned {@link RunResult}
+     * addresses each entry's outputs by its caller key (`res.byKey('hero')`); one
+     * failed entry lands in `failed` without sinking the rest.
+     *
+     * v1 accepts ONLY single-input {@link Recipe} entries — the multi-input
+     * builders ({@link FilesRecipe} via `files(...)`, `merge(...)`, `archive(...)`,
+     * `watermark(...)`) are rejected pre-upload with a typed {@link GislConfigError}.
+     * `.run()`-only; `.submit()` / reattach are a follow-up.
+     */
+    batch(recipes: ReadonlyArray<Recipe>): BatchRecipe;
     /**
      * Reattach to a previously-created workflow (FF5a). Returns a client-bound
      * {@link Handle} you can `.status()` / `.wait()` / `.result()`. The handle
@@ -100,8 +130,28 @@ export type ErgonomicClient = GislClient & {
      */
     workflow(id: string): Handle;
     compress(input: string | Blob, options?: Record<string, unknown>): OperationBuilder;
-    convert(input: string | Blob, options?: Record<string, unknown>): OperationBuilder;
-    thumbnail(input: string | Blob, options?: Record<string, unknown>): OperationBuilder;
+    /**
+     * Single-op convert. The target format rides the bag as the required
+     * `output_format` (the single-op builder has no positional format — that is
+     * the file-first `Recipe.convert(format, …)` surface). Extra keys are the
+     * typed {@link ConvertOptions}. A missing `output_format` is a compile-time
+     * error (uFbM31dC); an unknown key is a compile-time error for an INLINE bag
+     * only — aliased bags bypass TS excess-property checks — so the runtime guard
+     * remains the backstop (also for untyped JS callers).
+     */
+    convert(input: string | Blob, options: ConvertOptions & {
+        output_format: string;
+    }): OperationBuilder;
+    /**
+     * Single-op thumbnail. {@link ThumbnailOptions} requires `width` + `height`;
+     * omitting either is a compile-time error (uFbM31dC). An unknown key is a
+     * compile-time error for an INLINE bag only — aliased bags bypass TS
+     * excess-property checks — so the runtime guard remains the backstop (also
+     * for untyped JS callers).
+     */
+    thumbnail(input: string | Blob, options: ThumbnailOptions): OperationBuilder;
+    /** Geometric transform (rotate/flip). Passthrough; the op is `planned` (server 422s until Lambdas ship). */
+    transform(input: string | Blob, options?: Record<string, unknown>): OperationBuilder;
     /**
      * Merge ordered-sequence factory (T3). Accepts a variadic list of assets
      * (strings/Blobs/`handle()`/`asset()`) optionally terminated by a
@@ -135,6 +185,44 @@ export type ErgonomicClient = GislClient & {
     creditsUsage(options?: CreditsUsageOptions): Promise<CreditsUsageResponse>;
     /** Effective account limits / tier-resolved caps (sugar for `getAccountLimits()`). */
     limits(): Promise<AccountLimits>;
+    /**
+     * Operation-capability read helper (qUhxfDA5). A typed projection over
+     * `getSchema()` that surfaces the tier-scoped operation-capability matrix,
+     * the output-property table, and the image-encode capability matrix —
+     * without dropping to the low-level `getSchema()` and its not-modified union.
+     *
+     * Called with no argument it returns the full {@link CapabilitiesSnapshot};
+     * called with an operation type it returns just that op's
+     * {@link OperationCapability}, or `undefined` when the op is absent from the
+     * server's capability matrix.
+     *
+     * Degraded fallback: if the client is configured to force conditional
+     * revalidation (a static `If-None-Match` in `config.headers`) the schema
+     * fetch may 304 with no body — in that case the snapshot is empty / the
+     * per-op lookup is `undefined`.
+     */
+    capabilities(): Promise<CapabilitiesSnapshot>;
+    capabilities(opType: OperationType | (string & {})): Promise<OperationCapability | undefined>;
+    /**
+     * Generic operation escape hatch (qUhxfDA5). Build + run a SINGLE-input,
+     * SINGLE-operation job for an op type with no first-class verb (e.g.
+     * `text_watermark`, `split`, or a not-yet-in-contract op). `options` reach the
+     * wire unchanged — there is NO pre-upload validation (the server validates) and
+     * NO preset resolution unless `opType` is `compress`. Prefer the typed verbs
+     * (`compress` / `convert` / `thumbnail`) when they exist — they add local
+     * validation.
+     *
+     * Multi-input operations (`merge`, `archive`, overlay watermarks — see
+     * {@link MultiInputOperationType}) are REJECTED at compile time: passing one
+     * of those literals is a type error (its dedicated builder is `merge(...)`,
+     * `files(...).archive(...)`, or `file(a).watermark(b)`). A genuinely-unknown
+     * (not-yet-in-contract) op string is still accepted.
+     *
+     * The generic parameter enforces the exclusion: a known single-input op or an
+     * unknown string maps to itself, while a {@link MultiInputOperationType}
+     * literal maps to `never` (so it cannot be passed).
+     */
+    operation<Op extends SingleInputOperationType>(opType: Op extends MultiInputOperationType ? never : Op, input: string | Blob, options?: Record<string, unknown>): OperationBuilder;
 };
 /**
  * The `gisl` namespace — primary ergonomic-layer entry point.

package/dist/gisl.js

@@ -20,9 +20,10 @@ import { GislClient } from './client.js';
 import { GislConfigError, GislFeatureRequiresAuthError, GislMissingCredentialsError, } from './errors.js';
 import { resolveApiKey, resolveEndpoint, } from './credentials.js';
 import { OperationBuilder } from './builder.js';
+import { validateVerbOptions, validateSingleOpConvertOptions, assertThumbnailDimensions, } from './ergonomic/option_validation.js';
 import { MergeBuilder, asset } from './merge.js';
 import { PresetDefaults } from './ergonomic/presets/index.js';
-import { Recipe, FilesRecipe, fileInput } from './file-first.js';
+import { Recipe, FilesRecipe, BatchRecipe, fileInput } from './file-first.js';
 import { Handle } from './handle.js';
 // ---------------------------------------------------------------------------
 // Anonymous-capable operation allowlist (internal)
@@ -112,14 +113,42 @@ function wrapErgonomic(client, presetDefaults, scopedPresetDefaults) {
                     return new FilesRecipe(resolved, [], presetDefaults, scopedPresetDefaults, target);
                 };
             }
+            if (prop === 'batch') {
+                // Keyed multi-recipe batch entry point (FF7). Run N DISTINCT single-input
+                // keyed recipes as ONE workflow; run() partitions the RunResult per entry
+                // by the caller key given at `file(input, key)` time. Client-only ctor —
+                // each entry already captured its own preset defaults at `client.file(...)`
+                // time, so batch never re-plumbs presetDefaults/scopedPresetDefaults.
+                return (recipes) => new BatchRecipe(recipes, target);
+            }
             if (prop === 'workflow') {
                 // Reattach to a previously-created workflow (FF5a). Returns a
                 // client-bound Handle with no webhookSecret and no recipe key —
                 // its RunResult is therefore keyless (succeeded[].key === null).
                 return (id) => new Handle(id, undefined, target);
             }
-            if (prop === 'compress' || prop === 'convert' || prop === 'thumbnail') {
+            if (prop === 'compress' || prop === 'convert' || prop === 'thumbnail' || prop === 'transform') {
                 return (input, options = {}) => {
+                    // ExVcchMz — validate the option bag pre-upload for the exported
+                    // single-op builder so a bad bag (unknown key / missing thumbnail dims /
+                    // missing convert target) fails locally instead of as a server 422.
+                    // `compress` is EXCLUDED: it validates through the preset resolver
+                    // (resolveCompressOptions / KNOWN_WIRE_FIELDS), not these guards.
+                    // `convert` uses a SINGLE-OP-specific guard (NOT validateVerbOptions):
+                    // the single-op builder has no positional format, so its target rides
+                    // the bag as `output_format` — which the file-first convert guard would
+                    // reject as positional-owned. `thumbnail` reuses the file-first guards
+                    // (it has no positional-owned keys).
+                    if (prop === 'convert')
+                        validateSingleOpConvertOptions(options);
+                    if (prop === 'thumbnail') {
+                        validateVerbOptions('thumbnail', options);
+                        assertThumbnailDimensions(options);
+                    }
+                    // `transform` is a passthrough (rotate/flip); no positional-owned keys
+                    // and no required dims — just the generic key-validation.
+                    if (prop === 'transform')
+                        validateVerbOptions('transform', options);
                     // T4b — pass client-scope presetDefaults into the builder so
                     // .run()/.submit() consult the preset resolver. The Proxy's
                     // closure carries the same reference for every per-call
@@ -178,6 +207,47 @@ function wrapErgonomic(client, presetDefaults, scopedPresetDefaults) {
             if (prop === 'limits') {
                 return () => target.getAccountLimits();
             }
+            if (prop === 'capabilities') {
+                // qUhxfDA5 — READ/PROJECTION over getSchema() surfacing the three
+                // v2.124 capability fields (previously typed but with no ergonomic
+                // consumer). No arg → the full CapabilitiesSnapshot; an opType → that
+                // op's OperationCapability (or undefined when absent).
+                return async (opType) => {
+                    const schema = await target.getSchema();
+                    // capabilities() passes no conditional headers, so getSchema()
+                    // normally returns the 200 hit with data. A 304 is only possible if
+                    // the caller globally configured a conditional header (e.g. a static
+                    // `If-None-Match` in `config.headers`) — an unusual, self-inflicted
+                    // case. Rather than throw, degrade to an empty projection (documented
+                    // on the method); a caller who forces revalidation gets no snapshot.
+                    const data = schema.notModified ? undefined : schema.data;
+                    const operations = data?.capabilities ?? {};
+                    if (opType !== undefined) {
+                        return operations[opType];
+                    }
+                    return {
+                        operations,
+                        outputProperties: data?.outputProperties ?? {},
+                        ...(data?.imageEncodeCapabilities !== undefined
+                            ? { imageEncode: data.imageEncodeCapabilities }
+                            : {}),
+                    };
+                };
+            }
+            if (prop === 'operation') {
+                // qUhxfDA5 — generic escape-hatch sibling of the single-op verbs
+                // (compress/convert/thumbnail). Builds a SINGLE-input, SINGLE-operation
+                // job for an op type with no typed verb (e.g. `text_watermark`, `split`,
+                // or a not-yet-in-contract op). Options ride through to the wire
+                // unchanged (no preset resolution unless opType is 'compress'); NO
+                // pre-upload validation — the server validates.
+                //
+                // Multi-input operations (merge, archive, image/video/audio overlay
+                // watermarks) canNOT be expressed here — they need multiple sources and
+                // have dedicated builders (`merge(...)`, `files(...).archive(...)`,
+                // `file(a).watermark(b)`). They are excluded from the op-type param.
+                return (opType, input, options = {}) => new OperationBuilder(target, opType, input, options, presetDefaults, scopedPresetDefaults);
+            }
             return Reflect.get(target, prop, receiver);
         },
     });

package/dist/handle.d.ts

@@ -97,7 +97,7 @@ export declare class Handle {
      * This is the ONLY blocking accessor on a `Handle`.
      *
      * @param maxWait Wall-clock deadline for the wait + downloads (string suffix
-     *   `'2h'`/`'30m'`/`'120s'` or a number of milliseconds). Defaults to 300s,
+     *   `'2h'`/`'30m'`/`'120s'` or a number of milliseconds). Defaults to 600s,
      *   matching `Recipe.run()` / the PHP `Handle::wait()` default.
      * @throws {GislConfigError} reason `no_client` when no client is bound.
      * @throws {GislTimeoutError} when `maxWait` elapses before terminal.
@@ -125,6 +125,11 @@ export declare class Handle {
      *    empty `keyByRef`, so each input's key is recovered from its `file-{i}`
      *    ref (`"0"`, `"1"`, …). A submitted/reattached fan-out carries no
      *    caller-supplied keys — keyed fan-out is a separate concern.
+     *  - A `merge` / `archive` / `watermark` shape ({@link isMergeStatus} /
+     *    {@link isArchiveStatus} / {@link isWatermarkStatus}) → project ONLY the
+     *    terminal deliverable, filtering the `src_*` passthrough plumbing. The
+     *    terminal ref is the downstream `post` job when post-`sole_op` steps were
+     *    chained ({@link terminalOutputRef}), else the sole_op job itself.
      *  - Anything else (the single-file {@link Recipe} path) →
      *    {@link projectDownloadsToRunResult} keyed by this handle's `#key`
      *    (the recipe key from a file-first `submit()`, or `null` on reattach).

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, isWatermarkStatus, } from './file-first.js';
+import { projectDownloadsToRunResult, projectMultiJobToRunResult, isFanoutStatus, isMergeStatus, isArchiveStatus, isWatermarkStatus, isSoleOpChainStatus, soleOpChainDeliverableRef, _POST_STEP_JOB_REF, } from './file-first.js';
 import { LazyHttpDownloader } from './lazy-downloader.js';
 /**
  * The terminal workflow states. A status response in any of these states
@@ -80,6 +80,16 @@ export class StatusSnapshot {
         return { workflowId: this.workflowId, state: this.state };
     }
 }
+/**
+ * The terminal deliverable's job ref for a `sole_op` DAG: the downstream
+ * post-steps job ({@link _POST_STEP_JOB_REF}, present when the caller chained
+ * ops after `watermark()` / `merge()`) when it exists, else the `sole_op` job
+ * itself. Lets a submitted/reattached {@link Handle} project the final output —
+ * not the intermediate `sole_op` artifact — without builder state. PIiUit28.
+ */
+function terminalOutputRef(jobDownloads, soleOpRef) {
+    return jobDownloads.some((d) => d.ref === _POST_STEP_JOB_REF) ? _POST_STEP_JOB_REF : soleOpRef;
+}
 /**
  * Handle to a created workflow. Carries `workflowId` + an optional
  * `webhookSecret` (the data the operation-first/merge `submit()` returns)
@@ -139,12 +149,12 @@ export class Handle {
      * This is the ONLY blocking accessor on a `Handle`.
      *
      * @param maxWait Wall-clock deadline for the wait + downloads (string suffix
-     *   `'2h'`/`'30m'`/`'120s'` or a number of milliseconds). Defaults to 300s,
+     *   `'2h'`/`'30m'`/`'120s'` or a number of milliseconds). Defaults to 600s,
      *   matching `Recipe.run()` / the PHP `Handle::wait()` default.
      * @throws {GislConfigError} reason `no_client` when no client is bound.
      * @throws {GislTimeoutError} when `maxWait` elapses before terminal.
      */
-    async wait(maxWait = 300_000, onProgress) {
+    async wait(maxWait = 600_000, onProgress) {
         const client = this.requireClient();
         const deadline = Date.now() + _parseMaxWait(maxWait);
         let finalStatus;
@@ -172,13 +182,13 @@ export class Handle {
             });
         }
         if (Date.now() >= deadline) {
-            throw new GislTimeoutError(`Workflow ${this.workflowId} reached terminal status but maxWait elapsed before downloads could be fetched`);
+            throw new GislTimeoutError(`Workflow ${this.workflowId} reached terminal status but maxWait elapsed before downloads could be fetched`, this.workflowId);
         }
         const downloads = await client.getWorkflowDownloads(this.workflowId);
         // TDqmkWpX: re-check AFTER the downloads fetch so a slow getWorkflowDownloads
         // cannot return a success past the advertised maxWait.
         if (Date.now() >= deadline) {
-            throw new GislTimeoutError(`Workflow ${this.workflowId} downloads fetch completed after maxWait elapsed`);
+            throw new GislTimeoutError(`Workflow ${this.workflowId} downloads fetch completed after maxWait elapsed`, this.workflowId);
         }
         return this.project(finalStatus, downloads.downloads);
     }
@@ -212,6 +222,11 @@ export class Handle {
      *    empty `keyByRef`, so each input's key is recovered from its `file-{i}`
      *    ref (`"0"`, `"1"`, …). A submitted/reattached fan-out carries no
      *    caller-supplied keys — keyed fan-out is a separate concern.
+     *  - A `merge` / `archive` / `watermark` shape ({@link isMergeStatus} /
+     *    {@link isArchiveStatus} / {@link isWatermarkStatus}) → project ONLY the
+     *    terminal deliverable, filtering the `src_*` passthrough plumbing. The
+     *    terminal ref is the downstream `post` job when post-`sole_op` steps were
+     *    chained ({@link terminalOutputRef}), else the sole_op job itself.
      *  - Anything else (the single-file {@link Recipe} path) →
      *    {@link projectDownloadsToRunResult} keyed by this handle's `#key`
      *    (the recipe key from a file-first `submit()`, or `null` on reattach).
@@ -221,13 +236,16 @@ export class Handle {
         if (isFanoutStatus(finalStatus)) {
             return projectMultiJobToRunResult(this.workflowId, finalStatus, jobDownloads, new Map(), downloader);
         }
-        // A fluent `files([...]).merge(...)` combine — project ONLY the merged
-        // output, filtering the `src_*` passthrough plumbing (which re-exposes the
-        // raw inputs). Matches MergedRecipe.run()'s `ref === 'merge'` filter so a
+        // A fluent `files([...]).merge(...)` combine — project ONLY the terminal
+        // deliverable, filtering the `src_*` passthrough plumbing (which re-exposes
+        // the raw inputs). Matches MergedRecipe.run()'s terminal-output filter so a
         // submitted/reattached merge handle never surfaces the input artifacts
         // alongside the combined output (codex c1).
         if (isMergeStatus(finalStatus)) {
-            const mergeDownloads = jobDownloads.filter((d) => d.ref === 'merge');
+            // Post-merge steps (PIiUit28) lower into the downstream `_POST_STEP_JOB_REF`
+            // job, which is then the deliverable; otherwise the `merge` job is.
+            const mergeOutputRef = terminalOutputRef(jobDownloads, 'merge');
+            const mergeDownloads = jobDownloads.filter((d) => d.ref === mergeOutputRef);
             return projectDownloadsToRunResult(this.workflowId, finalStatus, mergeDownloads, null, downloader);
         }
         // A fluent `files([...]).archive(...)` bundle — project ONLY the archive
@@ -237,14 +255,25 @@ 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
+        // A fluent `file(...).watermark(overlay)` — project ONLY the terminal
+        // deliverable, filtering the `src_*` (base/overlay) passthrough plumbing.
+        // Matches WatermarkedRecipe.run()'s terminal-output filter so a
         // submitted/reattached watermark handle never surfaces the raw inputs.
         if (isWatermarkStatus(finalStatus)) {
-            const watermarkDownloads = jobDownloads.filter((d) => d.ref === 'watermark');
+            const watermarkOutputRef = terminalOutputRef(jobDownloads, 'watermark');
+            const watermarkDownloads = jobDownloads.filter((d) => d.ref === watermarkOutputRef);
             return projectDownloadsToRunResult(this.workflowId, finalStatus, watermarkDownloads, null, downloader);
         }
+        // A single-input `sole_op` chain — e.g. `.textWatermark('x').compress()`
+        // lowered to a `text_watermark` job + downstream `post` job (IQc01rj0).
+        // Project ONLY the terminal deliverable, filtering the intermediate sole_op
+        // artifact. The recipe key is preserved (unlike the multi-input branches):
+        // this is the single-file path with a terminal-ref filter.
+        if (isSoleOpChainStatus(finalStatus)) {
+            const soleOpRef = soleOpChainDeliverableRef(finalStatus);
+            const soleOpDownloads = jobDownloads.filter((d) => d.ref === soleOpRef);
+            return projectDownloadsToRunResult(this.workflowId, finalStatus, soleOpDownloads, this.#key, downloader);
+        }
         return projectDownloadsToRunResult(this.workflowId, finalStatus, jobDownloads, this.#key, downloader);
     }
     /**

package/dist/index.core.d.ts

@@ -1,10 +1,11 @@
 export { GislClient, DEFAULT_MULTIPART_FIRST_CHUNK_SIZE } from './client.js';
 export { parseSseStream } from './sse.js';
-export type { CreditsUsageOptions, ListWorkflowsOptions, GetSchemaOptions, GetSchemaResult, PreflightClipError, PreflightClipsResult, ProbeWaitOptions, ProbeWaitResult, GislClientConfig, GislSseEvent, UploadOptions, WaitOptions, WorkflowCreatePayload, OperationDef, WorkflowSourcePayload, MultiInputSourcePayload, UploadSourcePayload, JobOutputSourcePayload, ExternalImportSourcePayload, ConnectionSourcePayload, JobInputV2Payload, JobDefinitionPayload, ExternalDestinationPayload, DeliveryPayload, DeliveryModePayload, DeliveryBundleFormatPayload, DeliverySelectionPayload, DeliverySelectionTypePayload, DeliveryOutputRefPayload, WorkflowProcessingPayload, ProcessingClassHintPayload, MultipartCheckpointState, _Sdk3HandCodedUploadedPart, _Sdk3HandCodedMultipartStatusResult, _Sdk3HandCodedPresignedPart, _Sdk3HandCodedPresignPartsResult, _Sdk3HandCodedKeepaliveResult, } from './types.js';
+export type { CreditsUsageOptions, ListWorkflowsOptions, GetSchemaOptions, GetSchemaResult, CapabilitiesSnapshot, PreflightClipError, PreflightClipsResult, ProbeWaitOptions, ProbeWaitResult, GislClientConfig, GislSseEvent, GislSseParseFailure, UploadOptions, WaitOptions, WorkflowCreatePayload, OperationDef, WorkflowSourcePayload, MultiInputSourcePayload, UploadSourcePayload, JobOutputSourcePayload, ExternalImportSourcePayload, ConnectionSourcePayload, JobInputV2Payload, JobDefinitionPayload, ExternalDestinationPayload, DeliveryPayload, DeliveryModePayload, DeliveryBundleFormatPayload, DeliverySelectionPayload, DeliverySelectionTypePayload, DeliveryOutputRefPayload, WorkflowProcessingPayload, ProcessingClassHintPayload, MultipartCheckpointState, _Sdk3HandCodedUploadedPart, _Sdk3HandCodedMultipartStatusResult, _Sdk3HandCodedPresignedPart, _Sdk3HandCodedPresignPartsResult, _Sdk3HandCodedKeepaliveResult, } from './types.js';
 export { uploadSource, jobOutputSource, externalImportSource, connectionSource, } from './types.js';
 export type { GislConfigErrorMetadata } from './errors.js';
-export { GislError, GislApiError, GislValidationError, GislBalanceExhaustedError, GislTierRestrictedError, GislFeatureTierRestrictedError, GislFeatureNotAvailableError, GislWorkflowExpiredError, GislProbePendingError, GislAuthError, GislUploadCapExceededError, GislMultipartPartError, GislMultipartPartCountError, GislMultipartSessionNotFoundError, GislMultipartSessionOwnershipError, GislMultipartSessionAuthRequiredError, GislTimeoutError, GislAbortError, GislNetworkError, GislConfigError, GislMissingCredentialsError, GislFeatureRequiresAuthError, GislUndeclaredAssetError, GislUnusedAssetError, GislPerInputOptionsNotSupportedError, GislChainCardinalityMismatchError, GislBundleAlreadyArchivedError, GislNoSuchKeyError, GislSinkError, GislItemFailedError, GislResultNotReadyError, } from './errors.js';
+export { GislError, GislApiError, GislValidationError, GislBalanceExhaustedError, GislLongFormConcurrencyError, GislTierRestrictedError, GislFeatureTierRestrictedError, GislFeatureNotAvailableError, GislWorkflowExpiredError, GislProbePendingError, GislAuthError, GislUploadCapExceededError, GislMultipartPartError, GislMultipartPartCountError, GislMultipartSessionNotFoundError, GislMultipartSessionOwnershipError, GislMultipartSessionAuthRequiredError, GislTimeoutError, GislAbortError, GislNetworkError, GislConfigError, GislMissingCredentialsError, GislFeatureRequiresAuthError, GislUndeclaredAssetError, GislUnusedAssetError, GislPerInputOptionsNotSupportedError, GislChainCardinalityMismatchError, GislBundleAlreadyArchivedError, GislNoSuchKeyError, GislSinkError, GislItemFailedError, GislResultNotReadyError, } from './errors.js';
 export type { GislApiErrorOptions, GislUploadCapKind } from './errors.js';
+export type { ErrorCategory } from './generated/sdk_spec/errors.js';
 export { RunResult } from './file-first.js';
 export type { OutputFile, ItemResult, ItemFailure, Manifest, Downloader, } from './file-first.js';
 export { Recipe, fileInput } from './file-first.js';
@@ -15,24 +16,25 @@ 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 { BatchRecipe } from './file-first.js';
 export { Handle, StatusSnapshot } from './handle.js';
 export { gisl, create } from './gisl.js';
-export type { GislCreateOptions, Environment, ErgonomicClient } from './gisl.js';
-export { presetDefaults, PresetDefaults, type PresetMedia, type PresetOp, type AnyPresetOptions, ImageCompressPresetOptions, type ImageCompressPresetOptionsInput, AudioCompressPresetOptions, type AudioCompressPresetOptionsInput, VideoCompressPresetOptions, type VideoCompressPresetOptionsInput, DocumentPdfCompressPresetOptions, type DocumentPdfCompressPresetOptionsInput, DocumentOfficeCompressPresetOptions, type DocumentOfficeCompressPresetOptionsInput, DocumentOdfCompressPresetOptions, type DocumentOdfCompressPresetOptionsInput, DocumentEpubCompressPresetOptions, type DocumentEpubCompressPresetOptionsInput, OptimizeFor, ImageMetadataPolicy, ImageFormat, VideoCodec, VideoPreset, VideoFit, AudioBitrate, AudioCodec, AudioSampleRate, PdfProfile, PdfColorspace, } from './ergonomic/presets/index.js';
+export type { GislCreateOptions, Environment, ErgonomicClient, SingleInputOperationType, MultiInputOperationType, } from './gisl.js';
+export { presetDefaults, PresetDefaults, type PresetMedia, type PresetOp, type AnyPresetOptions, ImageCompressPresetOptions, type ImageCompressPresetOptionsInput, AudioCompressPresetOptions, type AudioCompressPresetOptionsInput, VideoCompressPresetOptions, type VideoCompressPresetOptionsInput, DocumentOfficeCompressPresetOptions, type DocumentOfficeCompressPresetOptionsInput, DocumentOdfCompressPresetOptions, type DocumentOdfCompressPresetOptionsInput, DocumentEpubCompressPresetOptions, type DocumentEpubCompressPresetOptionsInput, OptimizeFor, ImageMetadataPolicy, ImageFormat, VideoCodec, VideoPreset, VideoFit, AudioBitrate, AudioCodec, AudioSampleRate, } from './ergonomic/presets/index.js';
 export { OperationBuilder, MapEachBuilder } from './builder.js';
 export { MergeBuilder, asset, handle, clip } from './merge.js';
 export type { Asset, ClipEntry, ClipOptions, MergeMediaKind, MergeOptions, SequenceEntry, } from './merge.js';
 export type { Artifact, ArtifactRef, JobBreakdown, OperationBreakdown, ProcessingProgressEvent, ProgressEvent, ResolvedOptions, ResolvedOptionsSources, Result, RunOptions, SubmitOptions, UploadProgressEvent, } from './builder.js';
 export { PRESET_VERSION, resolveCompressOptions } from './ergonomic/preset_resolver.js';
 export type { ResolveCompressOptionsInput, ResolveCompressOptionsOutput, } from './ergonomic/preset_resolver.js';
-export type { AccountLimits, AccountLimitsLimits, AccountLimitEntry, AudioWatermarkDecodeRequest, AudioWatermarkDecodeResponse, ContactRequest, CreditsBalanceResponse, CreditsUsageResponse, CreditTransaction, ExternalImportCreatedResponse, ExternalImportRequest, LoginUserRequest, LoginUser200ResponseData, LoginUser200ResponseDataUser, WorkflowCancelResponse, WorkflowResumeResponse, WorkflowPausedDetail, WorkflowPausedDetailLinks, UploadResponse, UploadConstraintsApplied, UploadProbeResponse, UploadProbeMediaMetadata, MultipartInitiateRequestMetadataHint, WorkflowCreateResponse, WorkflowStatusResponse, WorkflowListResponse, WorkflowSummary, WorkflowDownloadResponse, MetadataResponse, MetadataResponseDimensions, MetadataResponseExif, MetadataResponseExifGps, OperationsSchemaResponse, OperationSchemaDefinition, MimeGroupSchema, OptionSchema, PerValueAvailabilityEntry, PerRoleCardinalityEntry, RetryResponse, JobDownload, OperationDownload, DownloadBundle, WebhookPayload, WebhookOperationContext, JobResponse, OperationResponse, OperationResult, OperationResultMetrics, ExternalDestination, Delivery, DeliveryPlan, DeliveryPlanOutput, WorkflowProcessing, ProcessingPlan, ProcessingPlanJob, WorkflowEdge, WorkflowWarning, JobInputV2, WorkflowSource, UploadSource, JobOutputSource, ConnectionSource, ExternalImportToken, BalanceExhaustedResponse, BalanceExhaustedResponseAllOfLinks, TierRestrictionResponse, FeatureTierRestrictedResponse, FeatureNotAvailableResponse, FeatureViolation, WorkflowExpiredResponse, ProbePendingResponse, AuthErrorResponse, } from '@giveitsmaller/contracts/openapi';
+export type { AccountLimits, AccountLimitsLimits, AccountLimitEntry, AudioWatermarkDecodeRequest, AudioWatermarkDecodeResponse, ContactRequest, CreditsBalanceResponse, CreditsUsageResponse, CreditTransaction, ExternalImportCreatedResponse, ExternalImportRequest, LoginUserRequest, LoginUser200ResponseData, LoginUser200ResponseDataUser, WorkflowCancelResponse, WorkflowResumeResponse, WorkflowPausedDetail, WorkflowPausedDetailLinks, UploadResponse, UploadConstraintsApplied, UploadProbeResponse, UploadProbeMediaMetadata, MultipartInitiateRequestMetadataHint, WorkflowCreateResponse, WorkflowStatusResponse, WorkflowListResponse, WorkflowSummary, WorkflowDownloadResponse, MetadataResponse, MetadataResponseDimensions, MetadataResponseExif, MetadataResponseExifGps, OperationsSchemaResponse, OperationCapability, OutputProperties, ImageEncodeCapabilities, OperationSchemaDefinition, MimeGroupSchema, OptionSchema, PerValueAvailabilityEntry, PerRoleCardinalityEntry, RetryResponse, JobDownload, OperationDownload, DownloadBundle, WebhookPayload, WebhookOperationContext, JobResponse, OperationResponse, OperationResult, OperationResultMetrics, ExternalDestination, Delivery, DeliveryPlan, DeliveryPlanOutput, WorkflowProcessing, ProcessingPlan, ProcessingPlanJob, WorkflowEdge, WorkflowWarning, JobInputV2, WorkflowSource, UploadSource, JobOutputSource, ConnectionSource, ExternalImportToken, BalanceExhaustedResponse, BalanceExhaustedResponseAllOfLinks, LongFormConcurrencyLimitResponse, LongFormConcurrencyLimitResponseAllOfLinks, TierRestrictionResponse, FeatureTierRestrictedResponse, FeatureNotAvailableResponse, FeatureViolation, WorkflowExpiredResponse, ProbePendingResponse, AuthErrorResponse, } from '@giveitsmaller/contracts/openapi';
 export { AudioWatermarkDecodeRequestMethodHintEnum, AudioWatermarkDecodeResponseMethodEnum, OperationInputModel, ExternalImportRequestProviderHintEnum, ContactSubject, CreditTransactionSourceBucket, UploadProbeStatus, UploadProbeProcessingClass, WorkflowCancelBillingEffect, WorkflowPauseRequiredAction, WorkflowStatus, WarningType, WorkflowWarningSeverity, OperationType, SseEventType, CallbackEventType, OperationStatus, JobStatus, JobInputV2RoleEnum, AuthErrorType, TierRestrictionKind, BalanceExhaustedResponseRequiredActionEnum, ProcessingClassReason, DeliveryPlanReason, UserTier, ProcessingClass, } from '@giveitsmaller/contracts/openapi';
 export type { SseOperationProgressData, SseOperationCompletedData, SseOperationFailedData, SseJobCompletedData, SseJobFailedData, SseWorkflowTerminalData, } from '@giveitsmaller/contracts/openapi';
 export type { MultiOutputCompletion, PageIndexed, PositionIndexed, Unindexed, } from '@giveitsmaller/contracts/asyncapi';
 import type { MultiOutputCompletion as _MultiOutputCompletion } from '@giveitsmaller/contracts/asyncapi';
 export type OperationResultOutputEntry = _MultiOutputCompletion['outputs'][number];
-export type { CompressImageOptions, CompressImageJpegOptions, CompressImagePngOptions, CompressImageAvifOptions, CompressVideoOptions, CompressAudioOptions, CompressDocumentPdfOptions, CompressDocumentOfficeOptions, CompressDocumentOdfOptions, CompressDocumentEpubOptions, ThumbnailImageOptions, ThumbnailVideoOptions, ThumbnailDocumentOptions, ConvertImageOptions, ConvertVideoOptions, ConvertAudioOptions, ConvertDocumentPdfOptions, MergeImageOptions, MergeVideoOptions, MergeVideoPerInputOptions, MergeAudioOptions, MergeAudioPerInputOptions, ArchiveOptions, ImageWatermarkImageOptions, ImageWatermarkImageGifOptions, TextWatermarkImageOptions, CustomLumaVideoOptions, AudioOverlayAudioOptions, AudioOverlayVideoOptions, AudioWatermarkAudioOptions, AudioWatermarkVideoOptions, AudioToVideoAudioOptions, VideoWatermarkVideoOptions, VideoTextWatermarkVideoOptions, SplitImageGifOptions, SplitDocumentPdfOptions, SplitAudioOptions, SplitVideoOptions, } from '@giveitsmaller/contracts/operations';
+export type { CompressImageOptions, CompressImageJpegOptions, CompressImagePngOptions, CompressImageAvifOptions, CompressVideoOptions, CompressAudioOptions, CompressDocumentOfficeOptions, CompressDocumentOdfOptions, CompressDocumentEpubOptions, ThumbnailImageOptions, ThumbnailVideoOptions, ThumbnailDocumentOptions, TransformImageOptions, TransformImageGifOptions, TransformVideoOptions, TransformDocumentPdfOptions, ConvertImageOptions, ConvertVideoOptions, ConvertAudioOptions, ConvertDocumentPdfOptions, MergeImageOptions, MergeVideoOptions, MergeVideoPerInputOptions, MergeAudioOptions, MergeAudioPerInputOptions, ArchiveOptions, ImageWatermarkImageOptions, ImageWatermarkImageGifOptions, TextWatermarkImageOptions, CustomLumaVideoOptions, AudioOverlayAudioOptions, AudioOverlayVideoOptions, AudioWatermarkAudioOptions, AudioWatermarkVideoOptions, AudioToVideoAudioOptions, VideoWatermarkVideoOptions, VideoTextWatermarkVideoOptions, SplitImageGifOptions, SplitDocumentPdfOptions, SplitAudioOptions, SplitVideoOptions, } from '@giveitsmaller/contracts/operations';
 export { ImageWatermarkImageAnchor, ImageWatermarkImageGifAnchor, TextWatermarkImageAnchor, TextWatermarkImageFontFamily, TextWatermarkImageWatermarkMode, AudioOverlayAudioMode, AudioOverlayVideoMode, AudioOverlayVideoNoAudioTrackBehaviour, AudioWatermarkAudioMethod, AudioWatermarkAudioRobustness, AudioWatermarkAudioDensity, AudioWatermarkVideoMethod, AudioWatermarkVideoRobustness, AudioWatermarkVideoDensity, AudioToVideoAudioOutputResolution, AudioToVideoAudioImageFit, AudioToVideoAudioOutputFormat, VideoWatermarkVideoAnchor, VideoTextWatermarkVideoFontFamily, VideoTextWatermarkVideoWatermarkMode, VideoTextWatermarkVideoAnchor, SplitImageGifOutputFormat, SplitDocumentPdfMode, SplitAudioMode, SplitAudioPrecision, SplitVideoMode, SplitVideoPrecision, } from '@giveitsmaller/contracts/operations';
-export { archiveMetadata, audioOverlayMetadata, audioWatermarkMetadata, compressMetadata, convertMetadata, customLumaMetadata, imageWatermarkMetadata, mergeMetadata, textWatermarkMetadata, thumbnailMetadata, audioToVideoMetadata, videoWatermarkMetadata, videoTextWatermarkMetadata, splitMetadata, } from '@giveitsmaller/contracts/operations';
-export type { ConvertOptions, ThumbnailOptions, TextWatermarkOptions, WatermarkOptions, WatermarkAnchor, } from './ergonomic/option_types.js';
+export { archiveMetadata, audioOverlayMetadata, audioWatermarkMetadata, compressMetadata, convertMetadata, customLumaMetadata, imageWatermarkMetadata, mergeMetadata, textWatermarkMetadata, thumbnailMetadata, audioToVideoMetadata, videoWatermarkMetadata, videoTextWatermarkMetadata, splitMetadata, transformMetadata, } from '@giveitsmaller/contracts/operations';
+export type { ConvertOptions, ThumbnailOptions, TransformOptions, TextWatermarkOptions, WatermarkOptions, WatermarkOverlay, WatermarkAnchor, } from './ergonomic/option_types.js';
 export type { OperationMetadata, AvailabilityValue, AvailabilityEntry, FeatureEntry, MimeGroupMetadata, OptionMetadata, ProcessingClassConstraints, } from '@giveitsmaller/contracts/operations';