// packages/storage/src/index.ts —— 存储包统一出口：端口类型 + MinIO 适配器 + 错误 +
// env 工厂。api（Task 18 presign/verify）与 worker（Task 20 variants put/get）经
// `createStorageFromEnv()` 构造实例，测试/本地指向 MinIO，生产指向 OSS。
// commonjs 包（消费方 api/worker 均为 CJS）；@photo/contracts 为 ESM dist，运行时经
// Node require(esm) 消费（Node >= 22.12，见根 engines）。
import { MinioStorageAdapter, type MinioStorageConfig } from './minio.adapter';

export { MinioStorageAdapter } from './minio.adapter';
export type { MinioStorageConfig } from './minio.adapter';
export { StorageError, ErrorCodes } from './errors';
export type { StoragePort, UploadCredential } from './port';

/**
 * 从 S3_* 环境变量构造 MinIO/S3 兼容适配器（仓库根 .env 经 dotenv-cli 或
 * test/load-env.ts 注入）。任一变量缺失即抛错，禁止静默回退默认值。
 */
export function createStorageFromEnv(): MinioStorageAdapter {
  const config = {
    endpoint: process.env.S3_ENDPOINT,
    region: process.env.S3_REGION,
    accessKey: process.env.S3_ACCESS_KEY,
    secretKey: process.env.S3_SECRET_KEY,
    bucket: process.env.S3_BUCKET,
  } satisfies Record<keyof MinioStorageConfig, string | undefined>;
  const missing = Object.entries(config)
    .filter(([, value]) => !value)
    .map(([key]) => `S3_${key.toUpperCase()}`);
  if (missing.length > 0) {
    throw new Error(`createStorageFromEnv: 缺少环境变量 ${missing.join(', ')}（S3_* 配置见仓库根 .env）`);
  }
  return new MinioStorageAdapter(config as MinioStorageConfig);
}