@giveitsmaller/sdk 0.8.0 → 0.10.0

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,32 +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, } 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 { HttpDownloader } from './http-downloader.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, Handle, 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,75 +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, } 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 execution (FF2b / MfV0PDok) — Node streaming downloader bound by
-// `Recipe.run()` to write pre-signed output URLs to disk.
 export { HttpDownloader } from './http-downloader.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

@@ -26,7 +26,8 @@
  * assets both fail fast so the caller saves bandwidth on typo'd composes.
  */
 import type { GislClient } from './client.js';
-import { type Handle, type Result, type RunOptions, type SubmitOptions } from './builder.js';
+import { type Result, type RunOptions, type SubmitOptions } from './builder.js';
+import { Handle } from './handle.js';
 /**
  * A declared merge asset. `path` carries a string or Blob (deduped by
  * normalised source key); `handle` wraps an already-uploaded file (deduped
@@ -140,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>;