@giveitsmaller/sdk 0.6.0 → 0.7.0

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

@@ -0,0 +1,195 @@
+export declare const OptimizeFor: {
+    readonly Size: "Size";
+    readonly Balanced: "Balanced";
+    readonly Quality: "Quality";
+};
+export type OptimizeFor = typeof OptimizeFor[keyof typeof OptimizeFor];
+export declare const ImageMode: {
+    readonly Lossy: "lossy";
+    readonly Lossless: "lossless";
+    readonly Auto: "auto";
+};
+export type ImageMode = typeof ImageMode[keyof typeof ImageMode];
+export declare const ImageFormat: {
+    readonly Original: "original";
+    readonly Auto: "auto";
+    readonly Smallest: "smallest";
+    readonly Jpeg: "jpeg";
+    readonly Png: "png";
+    readonly Webp: "webp";
+    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";
+    readonly Copyright: "copyright";
+    readonly Sensitive: "sensitive";
+};
+export type ImageMetadataPolicy = typeof ImageMetadataPolicy[keyof typeof ImageMetadataPolicy];
+export declare const IccProfilePolicy: {
+    readonly Preserve: "preserve";
+    readonly Strip: "strip";
+    readonly Srgb: "srgb";
+};
+export type IccProfilePolicy = typeof IccProfilePolicy[keyof typeof IccProfilePolicy];
+export declare const VideoCodec: {
+    readonly H264: "h264";
+    readonly H265: "h265";
+    readonly Vp9: "vp9";
+    readonly Av1: "av1";
+};
+export type VideoCodec = typeof VideoCodec[keyof typeof VideoCodec];
+export declare const VideoPreset: {
+    readonly Ultrafast: "ultrafast";
+    readonly Superfast: "superfast";
+    readonly Veryfast: "veryfast";
+    readonly Faster: "faster";
+    readonly Fast: "fast";
+    readonly Medium: "medium";
+    readonly Slow: "slow";
+    readonly Slower: "slower";
+    readonly Veryslow: "veryslow";
+};
+export type VideoPreset = typeof VideoPreset[keyof typeof VideoPreset];
+export declare const VideoFit: {
+    readonly Max: "max";
+    readonly Crop: "crop";
+    readonly Scale: "scale";
+    readonly Pad: "pad";
+};
+export type VideoFit = typeof VideoFit[keyof typeof VideoFit];
+export declare const AudioBitrate: {
+    readonly _64: 64;
+    readonly _96: 96;
+    readonly _128: 128;
+    readonly _192: 192;
+    readonly _256: 256;
+    readonly _320: 320;
+};
+export type AudioBitrate = typeof AudioBitrate[keyof typeof AudioBitrate];
+export declare const AudioCodec: {
+    readonly Aac: "aac";
+    readonly Opus: "opus";
+    readonly Vorbis: "vorbis";
+    readonly Copy: "copy";
+};
+export type AudioCodec = typeof AudioCodec[keyof typeof AudioCodec];
+export declare const AudioSampleRate: {
+    readonly _22050: 22050;
+    readonly _44100: 44100;
+    readonly _48000: 48000;
+};
+export type AudioSampleRate = typeof AudioSampleRate[keyof typeof AudioSampleRate];
+export declare const PdfProfile: {
+    readonly Web: "web";
+    readonly Print: "print";
+    readonly Archive: "archive";
+    readonly Max: "max";
+};
+export type PdfProfile = typeof PdfProfile[keyof typeof PdfProfile];
+export declare const PdfColorspace: {
+    readonly Unchanged: "unchanged";
+    readonly Rgb: "rgb";
+    readonly Cmyk: "cmyk";
+    readonly Grayscale: "grayscale";
+};
+export type PdfColorspace = typeof PdfColorspace[keyof typeof PdfColorspace];
+/** Catalog of every ergonomic enum (canonicalName → wire). */
+export declare const ERGONOMIC_ENUMS: {
+    readonly OptimizeFor: {
+        readonly Size: "Size";
+        readonly Balanced: "Balanced";
+        readonly Quality: "Quality";
+    };
+    readonly ImageMode: {
+        readonly Lossy: "lossy";
+        readonly Lossless: "lossless";
+        readonly Auto: "auto";
+    };
+    readonly ImageFormat: {
+        readonly Original: "original";
+        readonly Auto: "auto";
+        readonly Smallest: "smallest";
+        readonly Jpeg: "jpeg";
+        readonly Png: "png";
+        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";
+        readonly Copyright: "copyright";
+        readonly Sensitive: "sensitive";
+    };
+    readonly IccProfilePolicy: {
+        readonly Preserve: "preserve";
+        readonly Strip: "strip";
+        readonly Srgb: "srgb";
+    };
+    readonly VideoCodec: {
+        readonly H264: "h264";
+        readonly H265: "h265";
+        readonly Vp9: "vp9";
+        readonly Av1: "av1";
+    };
+    readonly VideoPreset: {
+        readonly Ultrafast: "ultrafast";
+        readonly Superfast: "superfast";
+        readonly Veryfast: "veryfast";
+        readonly Faster: "faster";
+        readonly Fast: "fast";
+        readonly Medium: "medium";
+        readonly Slow: "slow";
+        readonly Slower: "slower";
+        readonly Veryslow: "veryslow";
+    };
+    readonly VideoFit: {
+        readonly Max: "max";
+        readonly Crop: "crop";
+        readonly Scale: "scale";
+        readonly Pad: "pad";
+    };
+    readonly AudioBitrate: {
+        readonly _64: 64;
+        readonly _96: 96;
+        readonly _128: 128;
+        readonly _192: 192;
+        readonly _256: 256;
+        readonly _320: 320;
+    };
+    readonly AudioCodec: {
+        readonly Aac: "aac";
+        readonly Opus: "opus";
+        readonly Vorbis: "vorbis";
+        readonly Copy: "copy";
+    };
+    readonly AudioSampleRate: {
+        readonly _22050: 22050;
+        readonly _44100: 44100;
+        readonly _48000: 48000;
+    };
+    readonly PdfProfile: {
+        readonly Web: "web";
+        readonly Print: "print";
+        readonly Archive: "archive";
+        readonly Max: "max";
+    };
+    readonly PdfColorspace: {
+        readonly Unchanged: "unchanged";
+        readonly Rgb: "rgb";
+        readonly Cmyk: "cmyk";
+        readonly Grayscale: "grayscale";
+    };
+};

package/dist/generated/sdk_spec/enums.js

@@ -0,0 +1,127 @@
+// CODE GENERATED — DO NOT EDIT.
+// Source: compression_contracts/sdk-spec/ (see sdk-spec/README.md).
+// Regenerate with: scripts/generate.py.
+// Top-level preset selector. Resolved client-side to concrete wire fields per presets.yaml.
+export const OptimizeFor = {
+    Size: "Size",
+    Balanced: "Balanced",
+    Quality: "Quality",
+};
+// Image compression algorithm. lossy = smaller file; lossless = no quality loss; auto = format-best.
+export const ImageMode = {
+    Lossy: "lossy",
+    Lossless: "lossless",
+    Auto: "auto",
+};
+// Image output format selection. Original keeps input; Auto picks best per browser support; Smallest tries all and returns smallest.
+export const ImageFormat = {
+    Original: "original",
+    Auto: "auto",
+    Smallest: "smallest",
+    Jpeg: "jpeg",
+    Png: "png",
+    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
+//   Copyright = keep only copyright/author fields
+//   Sensitive = keep EXIF but strip GPS/location (GDPR-friendly)
+export const ImageMetadataPolicy = {
+    All: "all",
+    None: "none",
+    Copyright: "copyright",
+    Sensitive: "sensitive",
+};
+// ICC color profile handling.
+export const IccProfilePolicy = {
+    Preserve: "preserve",
+    Strip: "strip",
+    Srgb: "srgb",
+};
+// Video codec. H264 = widest compatibility; H265/Av1 = better compression but slower.
+export const VideoCodec = {
+    H264: "h264",
+    H265: "h265",
+    Vp9: "vp9",
+    Av1: "av1",
+};
+// Encoding speed vs compression ratio trade-off (FFmpeg-style x264/x265 preset names).
+export const VideoPreset = {
+    Ultrafast: "ultrafast",
+    Superfast: "superfast",
+    Veryfast: "veryfast",
+    Faster: "faster",
+    Fast: "fast",
+    Medium: "medium",
+    Slow: "slow",
+    Slower: "slower",
+    Veryslow: "veryslow",
+};
+// Video resize mode. Only applies when width or height is set. Pad is video-only (image fit lacks pad).
+export const VideoFit = {
+    Max: "max",
+    Crop: "crop",
+    Scale: "scale",
+    Pad: "pad",
+};
+// Audio output bitrate in kbps. Shared between compress (audio + video.audioBitrate) cells.
+export const AudioBitrate = {
+    _64: 64,
+    _96: 96,
+    _128: 128,
+    _192: 192,
+    _256: 256,
+    _320: 320,
+};
+// Audio codec. Aac = widest compatibility; Opus = best quality/size; Copy = passthrough (no re-encode).
+export const AudioCodec = {
+    Aac: "aac",
+    Opus: "opus",
+    Vorbis: "vorbis",
+    Copy: "copy",
+};
+// Audio sample rate in Hz.
+export const AudioSampleRate = {
+    _22050: 22050,
+    _44100: 44100,
+    _48000: 48000,
+};
+// PDF optimization profile. Web = aggressive; Print = preserve quality; Archive = PDF/A; Max = smallest.
+export const PdfProfile = {
+    Web: "web",
+    Print: "print",
+    Archive: "archive",
+    Max: "max",
+};
+// 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,
+    ImageMode,
+    ImageFormat,
+    ImageFit,
+    ImageMetadataPolicy,
+    IccProfilePolicy,
+    VideoCodec,
+    VideoPreset,
+    VideoFit,
+    AudioBitrate,
+    AudioCodec,
+    AudioSampleRate,
+    PdfProfile,
+    PdfColorspace,
+};

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

@@ -0,0 +1,16 @@
+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" | "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 ErrorCategory = 'api' | 'config' | 'network' | 'auth' | 'validation' | 'chain';
+export type ErrorStatus = 'wired' | 'planned';
+export interface ErrorEntry {
+    readonly code: ErrorCode;
+    readonly category: ErrorCategory;
+    readonly source: string;
+    readonly status: ErrorStatus;
+    readonly httpStatus: number | null;
+    readonly retryable: boolean;
+    readonly sdkClass: string;
+    readonly description: string;
+    readonly metadataSchema: Readonly<Record<string, string>>;
+}
+export declare const ERROR_CODES: Readonly<Record<ErrorCode, ErrorEntry>>;
+export declare const ERROR_CATEGORIES: Readonly<Record<ErrorCategory, readonly ErrorCode[]>>;