@giveitsmaller/sdk 0.9.0 → 0.10.0

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

@@ -20,12 +20,6 @@ export declare const ImageFormat: {
     readonly Avif: "avif";
 };
 export type ImageFormat = typeof ImageFormat[keyof typeof ImageFormat];
-export declare const ImageFit: {
-    readonly Max: "max";
-    readonly Crop: "crop";
-    readonly Scale: "scale";
-};
-export type ImageFit = typeof ImageFit[keyof typeof ImageFit];
 export declare const ImageMetadataPolicy: {
     readonly All: "all";
     readonly None: "none";
@@ -122,11 +116,6 @@ export declare const ERGONOMIC_ENUMS: {
         readonly Webp: "webp";
         readonly Avif: "avif";
     };
-    readonly ImageFit: {
-        readonly Max: "max";
-        readonly Crop: "crop";
-        readonly Scale: "scale";
-    };
     readonly ImageMetadataPolicy: {
         readonly All: "all";
         readonly None: "none";

package/dist/generated/sdk_spec/enums.js

@@ -23,12 +23,6 @@ export const ImageFormat = {
     Webp: "webp",
     Avif: "avif",
 };
-// Image resize mode. Only applies when width or height is set (depends_on width/height in compress.yaml).
-export const ImageFit = {
-    Max: "max",
-    Crop: "crop",
-    Scale: "scale",
-};
 // Image metadata handling. Counter-intuitive wire naming:
 //   All       = strip everything (smallest file)
 //   None      = keep all EXIF/IPTC/XMP
@@ -113,7 +107,6 @@ export const ERGONOMIC_ENUMS = {
     OptimizeFor,
     ImageMode,
     ImageFormat,
-    ImageFit,
     ImageMetadataPolicy,
     IccProfilePolicy,
     VideoCodec,

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" | "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" | "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" | "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

@@ -150,6 +150,19 @@ export const ERROR_CODES = Object.freeze({
             "details": "array",
         }),
     }),
+    "validation_error": Object.freeze({
+        code: "validation_error",
+        category: "validation",
+        source: "error_type",
+        status: "wired",
+        httpStatus: 422,
+        retryable: false,
+        sdkClass: "GislValidationError",
+        description: "422 — `error_type` discriminator on `ValidationErrorEnvelope` (ADR-0018/0019); distinct from `validation_failed` (the `error` code), same `GislValidationError`. Carries `details[]`.",
+        metadataSchema: Object.freeze({
+            "details": "array",
+        }),
+    }),
     "cyclic_workflow_edges": Object.freeze({
         code: "cyclic_workflow_edges",
         category: "validation",
@@ -277,6 +290,17 @@ export const ERROR_CODES = Object.freeze({
             "uploadId": "string",
         }),
     }),
+    "upload_not_found": Object.freeze({
+        code: "upload_not_found",
+        category: "api",
+        source: "ErrorEnvelope.error",
+        status: "wired",
+        httpStatus: 404,
+        retryable: false,
+        sdkClass: "GislApiError",
+        description: "404 on POST /api/workflows — a referenced upload was not found, OR exists but is owned by a different identity (deliberate BOLA/IDOR existence-mask: reported as not-found, never 403, so the response does not reveal another user's upload exists). message_key upload.not_found. Wire token UPLOAD_NOT_FOUND keyed on the `error` field. Per ADR-0016 amendment.",
+        metadataSchema: Object.freeze({}),
+    }),
     "workflow_expired": Object.freeze({
         code: "workflow_expired",
         category: "api",
@@ -477,6 +501,7 @@ export const ERROR_CATEGORIES = Object.freeze({
         "feature_tier_restricted",
         "tier_restriction",
         "multipart_session_not_found",
+        "upload_not_found",
         "workflow_expired",
         "balance_exhausted",
         "feature_not_available",
@@ -504,6 +529,7 @@ export const ERROR_CATEGORIES = Object.freeze({
         "multipart_part_invalid",
         "multipart_part_count_exceeded",
         "validation_failed",
+        "validation_error",
         "cyclic_workflow_edges",
         "workflow_edge_references_unknown_job",
         "reserved_job_id_pattern",

package/dist/generated/sdk_spec/presets.js

@@ -8,7 +8,6 @@ export const PRESETS = Object.freeze({
             "quality": 65,
             "metadata": "All",
             "iccProfile": "Strip",
-            "autoOrient": true,
             "progressive": true,
             "outputFormat": "Smallest",
         }),
@@ -17,7 +16,6 @@ export const PRESETS = Object.freeze({
             "quality": 80,
             "metadata": "Sensitive",
             "iccProfile": "Preserve",
-            "autoOrient": true,
             "progressive": true,
             "outputFormat": "Auto",
         }),
@@ -25,7 +23,6 @@ export const PRESETS = Object.freeze({
             "mode": "Lossless",
             "metadata": "None",
             "iccProfile": "Preserve",
-            "autoOrient": true,
             "progressive": true,
             "outputFormat": "Original",
         }),

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

@@ -1,3 +1,3 @@
-export declare const SDK_SPEC_VERSION: "1.2.0";
+export declare const SDK_SPEC_VERSION: "1.5.0";
 export declare const PRESET_VERSION: "1.0";
-export declare const PRESET_CONFIG_HASH: "sha256:35aeb0b6b86edd9814ace5b75cfeef8a7b1432ecb8e4d5ee8b38d9187a0b45eb";
+export declare const PRESET_CONFIG_HASH: "sha256:dc48f4d31f4037cc07fb0686519122c03a55b03a41f05fbfc2af54e54950a0d2";

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.2.0";
+export const SDK_SPEC_VERSION = "1.5.0";
 export const PRESET_VERSION = "1.0";
-export const PRESET_CONFIG_HASH = "sha256:35aeb0b6b86edd9814ace5b75cfeef8a7b1432ecb8e4d5ee8b38d9187a0b45eb";
+export const PRESET_CONFIG_HASH = "sha256:dc48f4d31f4037cc07fb0686519122c03a55b03a41f05fbfc2af54e54950a0d2";

package/dist/handle.js

@@ -32,10 +32,10 @@
  *
  * Mirrors the PHP `Gisl\Sdk\Ergonomic\Handle` + `Gisl\Sdk\Ergonomic\StatusSnapshot`.
  */
-import { GislApiError, GislConfigError, GislResultNotReadyError, GislTimeoutError, } from './errors.js';
+import { GislConfigError, GislNetworkError, GislResultNotReadyError, GislTimeoutError, SseEndedWithoutTerminal, } from './errors.js';
 import { _consumeSseToTerminal, _pollToTerminal, _parseMaxWait, } from './builder.js';
-import { projectDownloadsToRunResult, projectMultiJobToRunResult, isFanoutStatus, } from './file-first.js';
-import { HttpDownloader } from './http-downloader.js';
+import { projectDownloadsToRunResult, projectMultiJobToRunResult, isFanoutStatus, isMergeStatus, isArchiveStatus, } from './file-first.js';
+import { LazyHttpDownloader } from './lazy-downloader.js';
 /**
  * The terminal workflow states. A status response in any of these states
  * will not change without caller action. Mirrors the `TERMINAL_STATUSES`
@@ -157,16 +157,14 @@ export class Handle {
             });
         }
         catch (err) {
-            // Mirror Recipe.run(): only genuine SSE transport / clean-stream-end
-            // failures fall through to poll. Caller-deadline, abort, and API errors
-            // MUST propagate — re-issuing the same doomed request via poll would mask
-            // them.
-            if (err instanceof GislTimeoutError)
-                throw err;
-            if (err instanceof DOMException && err.name === 'AbortError')
-                throw err;
-            if (err instanceof GislApiError)
+            // TDqmkWpX: mirror Recipe.run() — poll-fallback ONLY on a clean SSE
+            // stream-end (SseEndedWithoutTerminal) or a typed transport error
+            // (GislNetworkError). Everything else (timeout, abort, API, an onProgress
+            // callback throw, anything unexpected) MUST propagate — re-issuing the same
+            // doomed request via poll would mask the real failure.
+            if (!(err instanceof SseEndedWithoutTerminal || err instanceof GislNetworkError)) {
                 throw err;
+            }
             finalStatus = await _pollToTerminal(client, {
                 workflowId: this.workflowId,
                 deadline,
@@ -177,6 +175,11 @@ export class Handle {
             throw new GislTimeoutError(`Workflow ${this.workflowId} reached terminal status but maxWait elapsed before downloads could be fetched`);
         }
         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`);
+        }
         return this.project(finalStatus, downloads.downloads);
     }
     /**
@@ -218,6 +221,22 @@ 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
+        // 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');
+            return projectDownloadsToRunResult(this.workflowId, finalStatus, mergeDownloads, null, downloader);
+        }
+        // A fluent `files([...]).archive(...)` bundle — project ONLY the archive
+        // output, filtering the `src_*` passthrough plumbing (mirror of the merge
+        // branch for archive).
+        if (isArchiveStatus(finalStatus)) {
+            const archiveDownloads = jobDownloads.filter((d) => d.ref === 'archive');
+            return projectDownloadsToRunResult(this.workflowId, finalStatus, archiveDownloads, null, downloader);
+        }
         return projectDownloadsToRunResult(this.workflowId, finalStatus, jobDownloads, this.#key, downloader);
     }
     /**
@@ -240,8 +259,9 @@ export class Handle {
     }
     makeDownloader() {
         // Download URLs from getWorkflowDownloads are pre-signed and require no SDK
-        // auth, so the downloader issues a plain unauthenticated fetch.
-        return new HttpDownloader();
+        // auth, so the downloader issues a plain unauthenticated fetch. Lazy so the
+        // node:fs-importing HttpDownloader stays out of the browser static graph.
+        return new LazyHttpDownloader();
     }
     requireClient() {
         if (this.#client === undefined) {

package/dist/index.browser.d.ts

@@ -0,0 +1 @@
+export * from './index.core.js';

package/dist/index.browser.js

@@ -0,0 +1,14 @@
+// Browser entry point — selected by the `browser` exports condition in
+// package.json (Vite / webpack / Rollup / esbuild / Parcel; Node ignores it).
+//
+// Re-exports ONLY the browser-safe shared surface (`index.core.ts`). It
+// deliberately OMITS the Node-only `verifyWebhook` (node:crypto) and
+// `HttpDownloader` (node:fs) that the Node entry (`index.ts`) adds — keeping
+// `node:` built-ins out of the browser static import graph. A strict subset of
+// the Node entry by construction, so it cannot silently drift.
+//
+// Output sinks (`RunResult.downloadTo()` / `toFile()`) are Node-only and throw
+// `GislSinkError` in a browser by design — read `RunResult.artifacts[].url`
+// (or `RunResult.url` for a single output) and fetch it in the browser. See
+// docs/typescript/browser.md.
+export * from './index.core.js';

package/dist/index.core.d.ts

@@ -0,0 +1,35 @@
+export { GislClient, DEFAULT_MULTIPART_FIRST_CHUNK_SIZE } from './client.js';
+export { parseSseStream } from './sse.js';
+export type { CreditsUsageOptions, ListWorkflowsOptions, GetSchemaOptions, GetSchemaResult, PreflightClipError, PreflightClipsResult, 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 { 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, GislNoSuchKeyError, GislSinkError, GislResultNotReadyError, } from './errors.js';
+export type { GislApiErrorOptions, GislUploadCapKind } from './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';
+export type { FileInput } from './file-first.js';
+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 { 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, ImageMode, ImageMetadataPolicy, IccProfilePolicy, ImageFormat, VideoCodec, VideoPreset, VideoFit, AudioBitrate, AudioCodec, AudioSampleRate, PdfProfile, PdfColorspace, } 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 { 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, 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 { 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, 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 { 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 { OperationMetadata, AvailabilityValue, AvailabilityEntry, FeatureEntry, MimeGroupMetadata, OptionMetadata, ProcessingClassConstraints, } from '@giveitsmaller/contracts/operations';

package/dist/index.core.js

@@ -0,0 +1,102 @@
+// Browser-safe shared surface. The Node-only entry (`index.ts`) re-exports
+// everything here PLUS the Node-only symbols (`verifyWebhook`, `HttpDownloader`)
+// that statically import node:crypto / node:fs; the browser entry
+// (`index.browser.ts`) re-exports ONLY this core, so it is a strict subset by
+// construction (no hand-maintained subset to drift). Keep this file free of any
+// static `node:` import — see the bundle-gate test.
+// SDK classes and functions
+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, 
+// SDK-3 (Wb6ebOMM) — typed errors for the 3 resume-support endpoints.
+GislMultipartSessionNotFoundError, GislMultipartSessionOwnershipError, GislMultipartSessionAuthRequiredError, GislTimeoutError, GislAbortError, 
+// FF2b / tywwynmN — transport-level failure (mirrors PHP GislNetworkError);
+// raised by the file-first HttpDownloader when an output URL cannot be read.
+GislNetworkError, 
+// T1 / wVU4xHx3 — local config-error tree (pre-I/O; sibling of GislApiError).
+GislConfigError, GislMissingCredentialsError, GislFeatureRequiresAuthError, 
+// T3 / cuecCmb5 — merge-compose local validation errors.
+GislUndeclaredAssetError, GislUnusedAssetError, GislPerInputOptionsNotSupportedError, 
+// T6 / aDR1jnyZ — chain-cardinality validation (dormant until chain
+// methods on OperationBuilder ship; type + audit registration land
+// here so the future chain-method PR is a pure addition).
+GislChainCardinalityMismatchError, 
+// FF1 / 3BIxEnfR — file-first result sink errors.
+GislNoSuchKeyError, GislSinkError, 
+// FF5a / Ao8RPVxD — thrown by the file-first Handle.result() when the
+// workflow is not yet terminal (the non-blocking accessor).
+GislResultNotReadyError, } from './errors.js';
+// File-first result surface (FF1 / 3BIxEnfR) — coexists with the
+// operation-first `Result`/`Artifact` until FF6 removes the old layer.
+export { RunResult } from './file-first.js';
+// File-first builder (FF2a / MfV0PDok) — `client.file(path).op()...` lowering.
+export { Recipe, fileInput } from './file-first.js';
+// File-first homogeneous fan-out (FF3a / u0hBt6fl) — `client.files([...]).op()...`
+// applies one recipe to many inputs in one workflow; run() partitions per input.
+// `projectMultiJobToRunResult` is intentionally NOT re-exported — it is the
+// @internal per-job producer consumed only by FilesRecipe.run (codex).
+export { FilesRecipe } from './file-first.js';
+// File-first N→1 combine (FF3b / IE29x9QL) — `client.files([...]).merge(opts?)`
+// returns a single-output MergedRecipe you chain post-combine ops on, then
+// run()/submit(). Mirrors the operation-first `client.merge()` wire shape.
+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';
+// `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
+// @internal helper shared between `file-first.ts` (Recipe.run) and `handle.ts`
+// (Handle.wait/result) via direct intra-package import, not public API (codex).
+// File-first Handle + StatusSnapshot (FF5a / Ao8RPVxD) — method-bearing,
+// client-bound value objects. `Handle` is the return of `submit()` (no client)
+// AND `client.workflow(id)` (client-bound, reattach). Exported as VALUES (the
+// prior `export type { Handle }` is replaced) because `Handle` is now a class.
+export { Handle, StatusSnapshot } from './handle.js';
+// Ergonomic-layer entrypoint (T1 / wVU4xHx3) — `gisl.create()` factory +
+// credential-chain types. `gisl.anonymous()` (public export) lands once
+// the anonymous-capable operation allowlist is non-empty (plan §12).
+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, ImageMode, ImageMetadataPolicy, IccProfilePolicy, ImageFormat, VideoCodec, VideoPreset, VideoFit, AudioBitrate, AudioCodec, AudioSampleRate, PdfProfile, PdfColorspace, } 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
+// SDK-synthesised `{phase:'upload'|'processing', ...}` discriminated union.
+export { OperationBuilder, MapEachBuilder } from './builder.js';
+export { MergeBuilder, asset, handle, clip } from './merge.js';
+// T4b — preset resolver public surface (PRESET_VERSION constant + types).
+export { PRESET_VERSION, resolveCompressOptions } from './ergonomic/preset_resolver.js';
+export { AudioWatermarkDecodeRequestMethodHintEnum, AudioWatermarkDecodeResponseMethodEnum, 
+// OperationInputModel — value-bearing enum (`single` | `multi`).
+// Surfaced on OperationSchemaDefinition.inputModel so form-renderers
+// can decide whether to render a single-file picker or a multi-file
+// input list.
+OperationInputModel, ExternalImportRequestProviderHintEnum, ContactSubject, CreditTransactionSourceBucket, UploadProbeStatus, UploadProbeProcessingClass, WorkflowCancelBillingEffect, WorkflowPauseRequiredAction, WorkflowStatus, WarningType, WorkflowWarningSeverity, OperationType, SseEventType, CallbackEventType, OperationStatus, JobStatus, JobInputV2RoleEnum, 
+// Error-payload discriminator enums — pair with the typed payload
+// types above for narrowing inside `error instanceof Gisl<X>Error`
+// branches.
+AuthErrorType, TierRestrictionKind, BalanceExhaustedResponseRequiredActionEnum, ProcessingClassReason, DeliveryPlanReason, 
+// UserTier + ProcessingClass — value-bearing forms (typeof const +
+// type alias). Sourced from openapi so consumers can do
+// `Object.values(UserTier)` for tier dropdowns or
+// `if (tier === UserTier.enterprise)` for narrowing typed error
+// payloads. The operations metadata-types versions are pure type
+// aliases (no runtime value); the openapi versions carry both the
+// string-union type and a const map. Per audit follow-up.
+UserTier, ProcessingClass, } from '@giveitsmaller/contracts/openapi';
+export { ImageWatermarkImageAnchor, ImageWatermarkImageGifAnchor, TextWatermarkImageAnchor, TextWatermarkImageFontFamily, TextWatermarkImageWatermarkMode, AudioOverlayAudioMode, AudioOverlayVideoMode, AudioOverlayVideoNoAudioTrackBehaviour, AudioWatermarkAudioMethod, AudioWatermarkAudioRobustness, AudioWatermarkAudioDensity, AudioWatermarkVideoMethod, AudioWatermarkVideoRobustness, AudioWatermarkVideoDensity, 
+// New planned operation enums — contracts v2.15 (AJCLLGaG).
+AudioToVideoAudioOutputResolution, AudioToVideoAudioImageFit, AudioToVideoAudioOutputFormat, VideoWatermarkVideoAnchor, VideoTextWatermarkVideoFontFamily, VideoTextWatermarkVideoWatermarkMode, VideoTextWatermarkVideoAnchor, SplitImageGifOutputFormat, SplitDocumentPdfMode, SplitAudioMode, SplitAudioPrecision, SplitVideoMode, SplitVideoPrecision, } from '@giveitsmaller/contracts/operations';
+// Per-operation metadata sidecars. Inspect `availability`,
+// `required_tier`, per-value gating, mime-group availability and
+// per-feature flags before submitting a workflow — the API will
+// otherwise reject planned ops with `feature_not_available` (422,
+// surfaces as `GislFeatureNotAvailableError`).
+export { archiveMetadata, audioOverlayMetadata, audioWatermarkMetadata, compressMetadata, convertMetadata, customLumaMetadata, imageWatermarkMetadata, mergeMetadata, textWatermarkMetadata, thumbnailMetadata, 
+// New planned operation metadata sidecars — contracts v2.15 (AJCLLGaG).
+audioToVideoMetadata, videoWatermarkMetadata, videoTextWatermarkMetadata, splitMetadata, } from '@giveitsmaller/contracts/operations';

package/dist/index.d.ts

@@ -1,34 +1,3 @@
-export { GislClient, DEFAULT_MULTIPART_FIRST_CHUNK_SIZE } from './client.js';
+export * from './index.core.js';
 export { verifyWebhook } from './webhook.js';
-export { parseSseStream } from './sse.js';
-export type { CreditsUsageOptions, GetSchemaOptions, GetSchemaResult, PreflightClipError, PreflightClipsResult, GislClientConfig, GislSseEvent, UploadOptions, WaitOptions, WorkflowCreatePayload, OperationDef, WorkflowSourcePayload, 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, GislNoSuchKeyError, GislSinkError, GislResultNotReadyError, } from './errors.js';
-export type { GislApiErrorOptions, GislUploadCapKind } from './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';
-export type { FileInput } from './file-first.js';
-export { FilesRecipe } from './file-first.js';
 export { HttpDownloader } from './http-downloader.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, ImageMode, ImageFit, ImageMetadataPolicy, IccProfilePolicy, ImageFormat, VideoCodec, VideoPreset, VideoFit, AudioBitrate, AudioCodec, AudioSampleRate, PdfProfile, PdfColorspace, } 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 { AudioWatermarkDecodeRequest, AudioWatermarkDecodeResponse, ContactRequest, CreditsBalanceResponse, CreditsUsageResponse, CreditTransaction, ExternalImportCreatedResponse, ExternalImportRequest, LoginUserRequest, LoginUser200ResponseData, LoginUser200ResponseDataUser, WorkflowCancelResponse, WorkflowResumeResponse, WorkflowPausedDetail, WorkflowPausedDetailLinks, UploadResponse, UploadConstraintsApplied, UploadProbeResponse, UploadProbeMediaMetadata, MultipartInitiateRequestMetadataHint, WorkflowCreateResponse, WorkflowStatusResponse, WorkflowDownloadResponse, MetadataResponse, MetadataResponseDimensions, MetadataResponseExif, MetadataResponseExifGps, OperationsSchemaResponse, OperationSchemaDefinition, MimeGroupSchema, OptionSchema, PerValueAvailabilityEntry, PerRoleCardinalityEntry, RetryResponse, JobDownload, OperationDownload, 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 { 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, 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 { 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 { OperationMetadata, AvailabilityValue, AvailabilityEntry, FeatureEntry, MimeGroupMetadata, OptionMetadata, ProcessingClassConstraints, } from '@giveitsmaller/contracts/operations';

package/dist/index.js

@@ -1,91 +1,11 @@
-// SDK classes and functions
-export { GislClient, DEFAULT_MULTIPART_FIRST_CHUNK_SIZE } from './client.js';
+// Node entry point — the package's `default` exports condition (and the
+// historical single entry). Re-exports the browser-safe shared surface
+// (`index.core.ts`) PLUS the Node-only symbols that statically import Node
+// built-ins: `verifyWebhook` (node:crypto) and `HttpDownloader` (node:fs).
+//
+// The browser entry (`index.browser.ts`, selected by the `browser` exports
+// condition) re-exports ONLY the core, omitting these two — so the browser
+// surface is a strict subset of this one by construction and cannot drift.
+export * from './index.core.js';
 export { verifyWebhook } from './webhook.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, 
-// SDK-3 (Wb6ebOMM) — typed errors for the 3 resume-support endpoints.
-GislMultipartSessionNotFoundError, GislMultipartSessionOwnershipError, GislMultipartSessionAuthRequiredError, GislTimeoutError, GislAbortError, 
-// FF2b / tywwynmN — transport-level failure (mirrors PHP GislNetworkError);
-// raised by the file-first HttpDownloader when an output URL cannot be read.
-GislNetworkError, 
-// T1 / wVU4xHx3 — local config-error tree (pre-I/O; sibling of GislApiError).
-GislConfigError, GislMissingCredentialsError, GislFeatureRequiresAuthError, 
-// T3 / cuecCmb5 — merge-compose local validation errors.
-GislUndeclaredAssetError, GislUnusedAssetError, GislPerInputOptionsNotSupportedError, 
-// T6 / aDR1jnyZ — chain-cardinality validation (dormant until chain
-// methods on OperationBuilder ship; type + audit registration land
-// here so the future chain-method PR is a pure addition).
-GislChainCardinalityMismatchError, 
-// FF1 / 3BIxEnfR — file-first result sink errors.
-GislNoSuchKeyError, GislSinkError, 
-// FF5a / Ao8RPVxD — thrown by the file-first Handle.result() when the
-// workflow is not yet terminal (the non-blocking accessor).
-GislResultNotReadyError, } from './errors.js';
-// File-first result surface (FF1 / 3BIxEnfR) — coexists with the
-// operation-first `Result`/`Artifact` until FF6 removes the old layer.
-export { RunResult } from './file-first.js';
-// File-first builder (FF2a / MfV0PDok) — `client.file(path).op()...` lowering.
-export { Recipe, fileInput } from './file-first.js';
-// File-first homogeneous fan-out (FF3a / u0hBt6fl) — `client.files([...]).op()...`
-// applies one recipe to many inputs in one workflow; run() partitions per input.
-// `projectMultiJobToRunResult` is intentionally NOT re-exported — it is the
-// @internal per-job producer consumed only by FilesRecipe.run (codex).
-export { FilesRecipe } from './file-first.js';
-// File-first execution (FF2b / MfV0PDok) — Node streaming downloader bound by
-// `Recipe.run()` to write pre-signed output URLs to disk.
 export { HttpDownloader } from './http-downloader.js';
-// `projectDownloadsToRunResult` is intentionally NOT re-exported here — it is an
-// @internal helper shared between `file-first.ts` (Recipe.run) and `handle.ts`
-// (Handle.wait/result) via direct intra-package import, not public API (codex).
-// File-first Handle + StatusSnapshot (FF5a / Ao8RPVxD) — method-bearing,
-// client-bound value objects. `Handle` is the return of `submit()` (no client)
-// AND `client.workflow(id)` (client-bound, reattach). Exported as VALUES (the
-// prior `export type { Handle }` is replaced) because `Handle` is now a class.
-export { Handle, StatusSnapshot } from './handle.js';
-// Ergonomic-layer entrypoint (T1 / wVU4xHx3) — `gisl.create()` factory +
-// credential-chain types. `gisl.anonymous()` (public export) lands once
-// the anonymous-capable operation allowlist is non-empty (plan §12).
-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, ImageMode, ImageFit, ImageMetadataPolicy, IccProfilePolicy, ImageFormat, VideoCodec, VideoPreset, VideoFit, AudioBitrate, AudioCodec, AudioSampleRate, PdfProfile, PdfColorspace, } 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
-// SDK-synthesised `{phase:'upload'|'processing', ...}` discriminated union.
-export { OperationBuilder, MapEachBuilder } from './builder.js';
-export { MergeBuilder, asset, handle, clip } from './merge.js';
-// T4b — preset resolver public surface (PRESET_VERSION constant + types).
-export { PRESET_VERSION, resolveCompressOptions } from './ergonomic/preset_resolver.js';
-export { AudioWatermarkDecodeRequestMethodHintEnum, AudioWatermarkDecodeResponseMethodEnum, 
-// OperationInputModel — value-bearing enum (`single` | `multi`).
-// Surfaced on OperationSchemaDefinition.inputModel so form-renderers
-// can decide whether to render a single-file picker or a multi-file
-// input list.
-OperationInputModel, ExternalImportRequestProviderHintEnum, ContactSubject, CreditTransactionSourceBucket, UploadProbeStatus, UploadProbeProcessingClass, WorkflowCancelBillingEffect, WorkflowPauseRequiredAction, WorkflowStatus, WarningType, WorkflowWarningSeverity, OperationType, SseEventType, CallbackEventType, OperationStatus, JobStatus, JobInputV2RoleEnum, 
-// Error-payload discriminator enums — pair with the typed payload
-// types above for narrowing inside `error instanceof Gisl<X>Error`
-// branches.
-AuthErrorType, TierRestrictionKind, BalanceExhaustedResponseRequiredActionEnum, ProcessingClassReason, DeliveryPlanReason, 
-// UserTier + ProcessingClass — value-bearing forms (typeof const +
-// type alias). Sourced from openapi so consumers can do
-// `Object.values(UserTier)` for tier dropdowns or
-// `if (tier === UserTier.enterprise)` for narrowing typed error
-// payloads. The operations metadata-types versions are pure type
-// aliases (no runtime value); the openapi versions carry both the
-// string-union type and a const map. Per audit follow-up.
-UserTier, ProcessingClass, } from '@giveitsmaller/contracts/openapi';
-export { ImageWatermarkImageAnchor, ImageWatermarkImageGifAnchor, TextWatermarkImageAnchor, TextWatermarkImageFontFamily, TextWatermarkImageWatermarkMode, AudioOverlayAudioMode, AudioOverlayVideoMode, AudioOverlayVideoNoAudioTrackBehaviour, AudioWatermarkAudioMethod, AudioWatermarkAudioRobustness, AudioWatermarkAudioDensity, AudioWatermarkVideoMethod, AudioWatermarkVideoRobustness, AudioWatermarkVideoDensity, 
-// New planned operation enums — contracts v2.15 (AJCLLGaG).
-AudioToVideoAudioOutputResolution, AudioToVideoAudioImageFit, AudioToVideoAudioOutputFormat, VideoWatermarkVideoAnchor, VideoTextWatermarkVideoFontFamily, VideoTextWatermarkVideoWatermarkMode, VideoTextWatermarkVideoAnchor, SplitImageGifOutputFormat, SplitDocumentPdfMode, SplitAudioMode, SplitAudioPrecision, SplitVideoMode, SplitVideoPrecision, } from '@giveitsmaller/contracts/operations';
-// Per-operation metadata sidecars. Inspect `availability`,
-// `required_tier`, per-value gating, mime-group availability and
-// per-feature flags before submitting a workflow — the API will
-// otherwise reject planned ops with `feature_not_available` (422,
-// surfaces as `GislFeatureNotAvailableError`).
-export { archiveMetadata, audioOverlayMetadata, audioWatermarkMetadata, compressMetadata, convertMetadata, customLumaMetadata, imageWatermarkMetadata, mergeMetadata, textWatermarkMetadata, thumbnailMetadata, 
-// New planned operation metadata sidecars — contracts v2.15 (AJCLLGaG).
-audioToVideoMetadata, videoWatermarkMetadata, videoTextWatermarkMetadata, splitMetadata, } from '@giveitsmaller/contracts/operations';

package/dist/lazy-downloader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Browser-safe {@link Downloader} that defers loading the Node-only
+ * {@link HttpDownloader} until a sink (`downloadTo` / `toFile`) actually runs.
+ *
+ * `HttpDownloader` statically imports `node:fs` / `node:stream`
+ * (`http-downloader.ts`). Binding it eagerly in `run()` would drag those
+ * built-ins into the ergonomic static import graph, breaking browser bundles
+ * even though the browser run path never writes to disk. This wrapper is what
+ * `run()` / `Handle` bind instead: it is constructed synchronously (no
+ * async ripple through the parity-pinned `RunResult` / `Handle`), and the
+ * `await import('./http-downloader.js')` only fires when a caller invokes a
+ * sink. A browser caller that reads `RunResult.artifacts[].url` never triggers
+ * the dynamic import, so `node:fs` stays out of the main browser chunk
+ * (bundlers code-split dynamic imports).
+ */
+import type { Downloader } from './file-first.js';
+export declare class LazyHttpDownloader implements Downloader {
+    downloadTo(url: string, destPath: string): Promise<void>;
+}

package/dist/lazy-downloader.js

@@ -0,0 +1,19 @@
+import { GislSinkError } from './errors.js';
+export class LazyHttpDownloader {
+    async downloadTo(url, destPath) {
+        // In a browser there is no filesystem — fail with the same clean
+        // `downloader_unavailable` GislSinkError a downloader-less RunResult throws,
+        // rather than a confusing module-load error from importing node:fs. Output
+        // is reachable via RunResult.artifacts[].url; fetch it in the browser.
+        if (typeof process === 'undefined' || process.versions?.node === undefined) {
+            throw new GislSinkError('Output sinks (downloadTo/toFile) require Node.js. In a browser, read ' +
+                'RunResult.url / RunResult.artifacts[].url and fetch it instead.', { reason: 'downloader_unavailable' });
+        }
+        // Magic comments keep bundlers (webpack/Vite) from pulling the Node-only
+        // http-downloader (node:fs/node:stream) into a browser build — they leave
+        // this as a literal runtime import that only Node ever reaches.
+        const { HttpDownloader } = await import(
+        /* webpackIgnore: true */ /* @vite-ignore */ './http-downloader.js');
+        return new HttpDownloader().downloadTo(url, destPath);
+    }
+}

package/dist/merge.d.ts

@@ -141,3 +141,14 @@ export declare class MergeBuilder {
     private opOptionsForResolved;
     private awaitTerminal;
 }
+/**
+ * Project the merge-level {@link MergeOptions} into the per-media wire
+ * allowlist. Exported so the file-first `MergedRecipe`
+ * (`files([...]).merge(...)`) lowers identically to this operation-first
+ * `client.merge(...)` builder — one allowlist, no drift. Mirrors the PHP
+ * `MergeBuilder::wireMergeOptions()` public-static seam.
+ *
+ * @internal Not re-exported from `index.ts`; shared between the two merge
+ *   surfaces only.
+ */
+export declare function wireMergeOptions(opts: MergeOptions, mediaKind: MergeMediaKind): Record<string, unknown>;