압축

import { defineConfig } from "sonamu";

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: false,      // API별로 제어
        threshold: 1024,    // 1KB 이상만 압축
        encodings: ["gzip", "br"],  // 지원 알고리즘
      },
    },
  },
  // ...
});

export default defineConfig({
  server: {
    plugins: {
      compress: true,  // 기본 설정으로 활성화
    },
  },
});

export default defineConfig({
  server: {
    plugins: {
      compress: false,  // 압축 비활성화
    },
  },
});

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: false,  // API별로 수동 제어
      },
    },
  },
});

export default defineConfig({
  server: {
    plugins: {
      compress: {
        threshold: 1024,  // 1KB 이상만 압축
      },
    },
  },
});

export default defineConfig({
  server: {
    plugins: {
      compress: {
        encodings: ["gzip", "br"],  // gzip과 brotli만
      },
    },
  },
});

import { defineConfig } from "sonamu";

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: false,      // API별로 제어
        threshold: 1024,    // 1KB 이상만
        encodings: ["gzip"], // gzip만 (빠름)
      },
    },
  },
});

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: false,
        threshold: 1024,
        encodings: ["br", "gzip"],  // Brotli 우선, gzip 대체
      },
    },
  },
});

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: true,       // 모든 응답 자동 압축
        threshold: 512,     // 512B 이상
        encodings: ["gzip"],
      },
    },
  },
});

import { api, compress } from "sonamu";

export class DataModel {
  // 압축 적용
  @compress()
  @api()
  static async getLargeData() {
    return {
      // 큰 데이터...
    };
  }
  
  // 압축 안 함 (작은 응답)
  @api()
  static async getSmallData() {
    return { status: "ok" };
  }
}

import { defineConfig } from "sonamu";

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: false,      // @compress() 데코레이터로 제어
        threshold: 1024,    // 1KB 이상만
        encodings: ["gzip"],
      },
    },
  },
});

export class ArticleModel {
  @compress()  // 큰 목록 응답
  @api()
  static async list() {
    return this.getPuri().select("*");
  }
  
  @compress()  // 큰 상세 데이터
  @api()
  static async detail(id: number) {
    return this.findById(id, ["**"]);
  }
  
  @api()  // 작은 응답은 압축 안 함
  static async save(data) {
    return { id: 123 };
  }
}

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: false,
        threshold: 2048,    // 2KB 이상만 (CDN 고려)
        encodings: ["br", "gzip"],  // Brotli 우선
      },
    },
  },
});

const isDev = process.env.NODE_ENV === "development";

export default defineConfig({
  server: {
    plugins: {
      compress: isDev
        ? false  // 개발: 압축 비활성화 (디버깅 편의)
        : {
            global: false,
            threshold: 1024,
            encodings: ["gzip"],
          },
    },
  },
});

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: false,
        threshold: 512,     // 작은 응답도 압축
        encodings: ["br"],  // Brotli만 (최고 압축률)
        brotliOptions: {
          params: {
            [zlib.constants.BROTLI_PARAM_QUALITY]: 11,  // 최대 품질
          },
        },
      },
    },
  },
});

import zlib from "zlib";

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: false,
        threshold: 1024,
        encodings: ["gzip"],
        zlibOptions: {
          level: zlib.constants.Z_BEST_COMPRESSION,  // 최대 압축
        },
      },
    },
  },
});

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: true,
        threshold: 1024,
        encodings: ["gzip"],
        customTypes: /^text\/|json$/,  // text/* 와 json만
      },
    },
  },
});

export default defineConfig({
  server: {
    plugins: {
      compress: {
        global: true,
        threshold: 1024,
        encodings: ["gzip"],
        removeContentLengthHeader: false,
        inflateIfDeflated: false,
        onUnsupportedEncoding: (encoding, request, reply) => {
          reply.code(406);  // Not Acceptable
          return "Unsupported encoding";
        },
      },
    },
  },
});

# gzip 압축 요청
curl -H "Accept-Encoding: gzip" http://localhost:1028/api/data -i

# 응답 헤더 확인
# Content-Encoding: gzip
# Content-Length: 1234

# Brotli 압축 요청
curl -H "Accept-Encoding: br" http://localhost:1028/api/data -i

// ❌ 나쁜 예: 이미지도 압축
compress: {
  global: true,  // 모든 것을 압축
}

// ✅ 좋은 예: API별로 제어
compress: {
  global: false,  // 필요한 것만 @compress()
}

// ❌ 나쁜 예: Brotli 최대 품질
compress: {
  encodings: ["br"],
  brotliOptions: {
    params: {
      [zlib.constants.BROTLI_PARAM_QUALITY]: 11,  // 너무 느림!
    },
  },
}

// ✅ 좋은 예: 적절한 균형
compress: {
  encodings: ["gzip"],  // 빠르고 충분한 압축률
}

// ❌ 나쁜 예: 너무 낮은 threshold
threshold: 100  // 100B - 오버헤드가 더 클 수 있음

// ✅ 좋은 예: 적절한 크기
threshold: 1024  // 1KB