truss-image 0.19.0

Image toolkit with a shared Rust core across the CLI, HTTP server, and WASM demo.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

import { signPublicUrl } from "@nao1215/truss-url-signer";
import type { OutputFormat, FitMode } from "@nao1215/truss-url-signer";
import { trussConfig, stableExpires } from "@/lib/truss";

interface TrussImageProps
  extends Omit<
    React.ImgHTMLAttributes<HTMLImageElement>,
    "src" | "width" | "height"
  > {
  /** Path to image on truss storage */
  src: string;
  /** Alt text */
  alt: string;
  /** Output width in pixels */
  width?: number;
  /** Output height in pixels */
  height?: number;
  /** Output format */
  format?: OutputFormat;
  /** Quality 1-100 (lossy formats only) */
  quality?: number;
  /** Fit mode when both width and height are set */
  fit?: FitMode;
}

/**
 * React Server Component that renders an image transformed by truss.
 * URL signing happens server-side at render time — the secret never reaches the browser.
 */
export function TrussImage({
  src,
  width,
  height,
  format,
  quality,
  fit,
  alt,
  ...imgProps
}: TrussImageProps) {
  const config = trussConfig();
  const signedUrl = signPublicUrl({
    baseUrl: config.publicBaseUrl,
    source: { kind: "path", path: src },
    transforms: { width, height, format, quality, fit },
    keyId: config.keyId,
    secret: config.secret,
    expires: stableExpires(config.ttlSeconds),
  });

  return (
    // eslint-disable-next-line @next/next/no-img-element
    <img src={signedUrl} width={width} height={height} alt={alt} {...imgProps} />
  );
}