Skip to content

SignedTransformOptions

type SignedTransformOptions = Omit<TransformOptions, "width"> & {
width?: number;
};

Defined in: packages/asset-client/src/transform.ts:130

Like TransformOptions but with width widened to any number — the escape hatch for SIGNED URLs that need an off-ladder custom width.

The edge whitelist only rejects off-ladder widths on UNSIGNED URLs; a valid ?sig= earns the whitelist bypass at the worker (the asset-manager still does the real HMAC check). So a custom width is ONLY safe when the URL is signed — hence this type is accepted exclusively by the signing helpers (getSignedTransformUrl / aq.transform(asset, opts, { sign: true })), never by the plain unsigned getTransformUrl.

optional width?: number;

Off-ladder width — valid ONLY on signed URLs (edge whitelist bypass).