@giveitsmaller/sdk 0.20.0 → 0.21.0

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

@@ -22,6 +22,7 @@ import { type ResolveCredentialsOptions, type ResolveEndpointOptions } from './c
 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, BatchRecipe, type FileInput } from './file-first.js';
@@ -129,8 +130,26 @@ 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;
     /**

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

@@ -3,7 +3,7 @@ export { parseSseStream } from './sse.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';
@@ -20,20 +20,20 @@ export { BatchRecipe } from './file-first.js';
 export { Handle, StatusSnapshot } from './handle.js';
 export { gisl, create } from './gisl.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, 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 { 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, 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, 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, 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 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, transformMetadata, } from '@giveitsmaller/contracts/operations';
 export type { ConvertOptions, ThumbnailOptions, TransformOptions, TextWatermarkOptions, WatermarkOptions, WatermarkOverlay, WatermarkAnchor, } from './ergonomic/option_types.js';

package/dist/index.core.js

@@ -9,7 +9,7 @@ export { GislClient, DEFAULT_MULTIPART_FIRST_CHUNK_SIZE } from './client.js';
 export { parseSseStream } from './sse.js';
 export { uploadSource, jobOutputSource, externalImportSource, connectionSource, } from './types.js';
 // Errors
-export { GislError, GislApiError, GislValidationError, GislBalanceExhaustedError, GislTierRestrictedError, GislFeatureTierRestrictedError, GislFeatureNotAvailableError, GislWorkflowExpiredError, GislProbePendingError, GislAuthError, GislUploadCapExceededError, GislMultipartPartError, GislMultipartPartCountError, 
+export { GislError, GislApiError, GislValidationError, GislBalanceExhaustedError, GislLongFormConcurrencyError, GislTierRestrictedError, GislFeatureTierRestrictedError, GislFeatureNotAvailableError, GislWorkflowExpiredError, GislProbePendingError, GislAuthError, GislUploadCapExceededError, GislMultipartPartError, GislMultipartPartCountError, 
 // SDK-3 (Wb6ebOMM) — typed errors for the 3 resume-support endpoints.
 GislMultipartSessionNotFoundError, GislMultipartSessionOwnershipError, GislMultipartSessionAuthRequiredError, GislTimeoutError, GislAbortError, 
 // FF2b / tywwynmN — transport-level failure (mirrors PHP GislNetworkError);
@@ -77,7 +77,7 @@ export { gisl, create } from './gisl.js';
 // Ergonomic preset defaults (T4a / VhIj4S7T) — typed leaf DTOs + immutable
 // `PresetDefaults` builder + `presetDefaults()` factory + ergonomic enum
 // re-exports. Resolver wiring (T4b) consumes `PresetDefaults.cellFor()`.
-export { presetDefaults, PresetDefaults, ImageCompressPresetOptions, AudioCompressPresetOptions, VideoCompressPresetOptions, DocumentPdfCompressPresetOptions, DocumentOfficeCompressPresetOptions, DocumentOdfCompressPresetOptions, DocumentEpubCompressPresetOptions, OptimizeFor, ImageMetadataPolicy, ImageFormat, VideoCodec, VideoPreset, VideoFit, AudioBitrate, AudioCodec, AudioSampleRate, PdfProfile, PdfColorspace, } from './ergonomic/presets/index.js';
+export { presetDefaults, PresetDefaults, ImageCompressPresetOptions, AudioCompressPresetOptions, VideoCompressPresetOptions, DocumentOfficeCompressPresetOptions, DocumentOdfCompressPresetOptions, DocumentEpubCompressPresetOptions, OptimizeFor, ImageMetadataPolicy, ImageFormat, VideoCodec, VideoPreset, VideoFit, AudioBitrate, AudioCodec, AudioSampleRate, } from './ergonomic/presets/index.js';
 // Operation-builder surface (T2 / xVDTIm8C) — `client.compress/convert/thumbnail`
 // returns an `OperationBuilder`; `.run()` projects to a flat `Result` /
 // `.submit({webhook})` returns a `Handle`. Progress events are the

package/dist/merge.js

@@ -128,14 +128,14 @@ export class MergeBuilder {
         });
         // 5. Fetch downloads + project.
         if (Date.now() >= deadline) {
-            throw new GislTimeoutError(`Merge workflow ${created.workflowId} reached terminal status but maxWait elapsed before downloads could be fetched`);
+            throw new GislTimeoutError(`Merge workflow ${created.workflowId} reached terminal status but maxWait elapsed before downloads could be fetched`, created.workflowId);
         }
         const downloads = await this.client.getWorkflowDownloads(created.workflowId);
         // TDqmkWpX: the maxWait deadline also covers the downloads fetch itself —
         // re-check AFTER the call so a slow getWorkflowDownloads cannot return a
         // success past the advertised whole-run deadline.
         if (Date.now() >= deadline) {
-            throw new GislTimeoutError(`Merge workflow ${created.workflowId} downloads fetch completed after maxWait elapsed`);
+            throw new GislTimeoutError(`Merge workflow ${created.workflowId} downloads fetch completed after maxWait elapsed`, created.workflowId);
         }
         // p0SuJEeK — project ONLY the merge job's output. getWorkflowDownloads
         // returns a download group per terminal job, which now INCLUDES the

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { OperationType, OperationsSchemaResponse, OperationCapability, OutputProperties, ImageEncodeCapabilities, CallbackEventType, SseEventType, SseOperationProgressData, SseOperationCompletedData, SseOperationFailedData, SseJobCompletedData, SseJobFailedData, SseWorkflowTerminalData, MultipartInitiateRequestMetadataHint, UploadProbeResponse } from '@giveitsmaller/contracts/openapi';
-import type { JobInputV2RoleEnum } from '@giveitsmaller/contracts/openapi';
+import type { JobInputV2RoleEnum, NotifyConfig } from '@giveitsmaller/contracts/openapi';
 export interface GislClientConfig {
     baseUrl: string;
     apiKey?: string;
@@ -188,6 +188,14 @@ export interface WorkflowCreatePayload {
     export?: ExternalDestinationPayload;
     delivery?: DeliveryPayload;
     processing?: WorkflowProcessingPayload;
+    /**
+     * Per-job completion notification (contracts v2.164.0, `notify.email`).
+     * Opaque passthrough wire shape — the ergonomic `notifyEmail` surface
+     * (SubmitOptions/RunOptions + builder convenience) is a separate follow-up
+     * (card y6jsQCpb); this field only acknowledges the wire key so a
+     * hand-built payload can carry it. Mirrors `export`/`delivery`/`processing`.
+     */
+    notify?: NotifyConfig;
 }
 /**
  * Single source of truth for WorkflowCreatePayload's top-level wire keys.
@@ -196,7 +204,7 @@ export interface WorkflowCreatePayload {
  * only via deep imports and should not be treated as public API.
  * @internal
  */
-export declare const WORKFLOW_CREATE_PAYLOAD_KEYS: readonly ["jobs", "source", "operations", "workflow_edges", "callback_url", "callback_events", "export", "delivery", "processing"];
+export declare const WORKFLOW_CREATE_PAYLOAD_KEYS: readonly ["jobs", "source", "operations", "workflow_edges", "callback_url", "callback_events", "export", "delivery", "processing", "notify"];
 export interface GetSchemaOptions {
     /** Filter the schema to operations that accept this MIME type (e.g. `image/jpeg`). */
     mimeType?: string;
@@ -322,7 +330,7 @@ export interface ReadCapabilityOptions {
 export interface WaitOptions {
     /** Poll interval in milliseconds (default: 2000) */
     intervalMs?: number;
-    /** Maximum wait time in milliseconds (default: 300000 = 5 min) */
+    /** Maximum wait time in milliseconds (default: 600000 = 10 min) */
     timeoutMs?: number;
     /** Called after each poll with current status */
     onPoll?: (status: string) => void;

package/dist/types.js

@@ -50,4 +50,5 @@ export const WORKFLOW_CREATE_PAYLOAD_KEYS = Object.freeze([
     'export',
     'delivery',
     'processing',
+    'notify',
 ]);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@giveitsmaller/sdk",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Node.js SDK for the GISL (Give It Smaller) file compression and processing API",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
@@ -31,7 +31,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@giveitsmaller/contracts": "^0.53.0"
+    "@giveitsmaller/contracts": "^0.59.0"
   },
   "devDependencies": {
     "@types/node": "^22",

package/dist/ergonomic/presets/document_pdf_compress.d.ts

@@ -1,12 +0,0 @@
-import { PdfProfile, OptimizeFor } from '../../generated/sdk_spec/enums.js';
-export interface DocumentPdfCompressPresetOptionsInput {
-    readonly profile?: PdfProfile;
-    readonly grayscale?: boolean;
-}
-export declare class DocumentPdfCompressPresetOptions {
-    readonly profile?: PdfProfile;
-    readonly grayscale?: boolean;
-    private constructor();
-    static from(input: DocumentPdfCompressPresetOptionsInput): DocumentPdfCompressPresetOptions;
-    static shippedDefaultsFor(level: OptimizeFor): DocumentPdfCompressPresetOptions;
-}

package/dist/ergonomic/presets/document_pdf_compress.js

@@ -1,33 +0,0 @@
-// T4a — DocumentPdfCompressPresetOptions leaf DTO.
-//
-// Field set (2): profile, grayscale — the worker-honored stable PDF controls
-// (contracts v2.96.0 Acrobat-PDF realignment Lw1LseYr). The earlier
-// {profile, colorspace, flattenForms} set was retired: colorspace + flatten_forms
-// are `planned` (not read by the worker) so presets never emit them, and
-// `image_dpi` + `pages` are per-call knobs, not preset cells.
-import { shippedDefaultsFor as f3ShippedDefaultsFor } from '../../generated/sdk_spec/presets.js';
-import { translateEnum } from './_translate.js';
-export class DocumentPdfCompressPresetOptions {
-    profile;
-    grayscale;
-    constructor(input) {
-        if (input.profile !== undefined)
-            this.profile = input.profile;
-        if (input.grayscale !== undefined)
-            this.grayscale = input.grayscale;
-        Object.freeze(this);
-    }
-    static from(input) {
-        return new DocumentPdfCompressPresetOptions(input);
-    }
-    static shippedDefaultsFor(level) {
-        const cell = f3ShippedDefaultsFor('document_pdf_compress', level);
-        const input = {};
-        const mut = input;
-        if ('profile' in cell)
-            mut.profile = translateEnum('PdfProfile', cell.profile);
-        if ('grayscale' in cell)
-            mut.grayscale = cell.grayscale;
-        return new DocumentPdfCompressPresetOptions(input);
-    }
-}