create-pardx-scaffold 0.1.0

package/template/apps/api/libs/infra/common/config/constant/config.constants.ts

@@ -0,0 +1,92 @@
+export const TRANSCODE_CONSTANTS = {
+  // 队列配置
+  QUEUES: {
+    TRANSCODE: 'transcode',
+  },
+
+  // 文件后缀
+  SUFFIXES: {
+    SNAPSHOT: '_snapshot',
+    SPRITE: '_sprite_',
+    MP3: '',
+    E4K: '_4k',
+    E1080P: '_1080p',
+    E720P: '_720p',
+    E360P: '_360p',
+    HDR2SDR: '.hdr2sdr',
+  },
+
+  // 超时配置
+  TIMEOUTS: {
+    SIGNED_URL: 3600, // 1小时
+    API_REQUEST: 30000, // 30秒
+  },
+
+  // 视频处理配置
+  VIDEO: {
+    SPRITE_INTERVAL: 3, // 雪碧图间隔秒数
+    DEFAULT_PRIORITY: 5,
+    MIN_DURATION: 0.1, // 最小时长
+  },
+
+  // API 路径
+  API_PATHS: {
+    TEMPLATES: '/templates',
+    SCHEMA: '/schema',
+    TASKS: '/tasks',
+    INFO: '?info',
+  },
+
+  SNAPSHOT_KEY: 'video/snapshot,t_0',
+
+  // 文件扩展名
+  EXTENSIONS: {
+    JPG: '.jpg',
+    MP4: '.mp4',
+    MP3: '.mp3',
+    WEBP: '.webp',
+  },
+
+  // 错误消息
+  ERROR_MESSAGES: {
+    INVALID_FILE: 'Invalid file for transcoding',
+    BUCKET_NOT_SUPPORTED: 'Bucket not supported for transcoding',
+    TEMPLATE_SCHEMA_FAILED: 'Failed to get template schemas',
+    TASK_CREATION_FAILED: 'Failed to create transcode task',
+    VIDEO_INFO_FAILED: 'Failed to get video information',
+  },
+} as const;
+
+export const SUPPORTED_VIDEO_FORMATS = [
+  'mp4',
+  'avi',
+  'mov',
+  'wmv',
+  'flv',
+  'webm',
+  'mkv',
+  'm4v',
+  '3gp',
+  'ogv',
+] as const;
+
+export const SUPPORTED_AUDIO_FORMATS = [
+  'mp3',
+  'wav',
+  'flac',
+  'aac',
+  'ogg',
+  'wma',
+  'm4a',
+] as const;
+
+export const SUPPORTED_IMAGE_FORMATS = [
+  'jpg',
+  'jpeg',
+  'png',
+  'gif',
+  'bmp',
+  'webp',
+  'tiff',
+  'svg',
+] as const;

package/template/apps/api/libs/infra/common/config/dto/config.dto.ts

@@ -0,0 +1,282 @@
+/**
+ * Configuration DTOs and Types
+ *
+ * 设计原则: 一次配置，多次使用
+ * - 配置相关类型从 Zod validation schema 推断 (单一真相来源)
+ * - 非配置相关的 DTO 类型在此定义
+ * - 保持向后兼容的类型别名
+ */
+import type {
+  SystemTaskQueue,
+  FileEnvType,
+  FileBucketVendor,
+} from '@prisma/client';
+import { ExtendedPaginatedResponse, PaginatedResponse } from '@repo/contracts';
+
+// ============================================================================
+// Re-export Zod-inferred Configuration Types (单一真相来源)
+// ============================================================================
+
+// YAML Configuration Types
+export type {
+  YamlConfig,
+  MicroServiceConfig,
+  AppConfig,
+  ZoneConfig,
+  UploadConfig,
+  IpInfoConfig,
+  JwtConfig,
+  CryptoConfig,
+  CdnZoneConfig,
+  CdnConfig,
+  RedisCacheKeyConfig,
+  WechatConfig,
+  PathConfig,
+  RolePermissionConfig,
+  BucketConfig,
+  VideoQuality,
+  // Database Metrics Types
+  SlowQueryThresholdsConfig,
+  DbMetricsConfig,
+  // Transaction Types
+  TransactionRetryConfig,
+  TransactionConfig,
+} from '../validation';
+
+// Keys Configuration Types
+export type {
+  KeysConfig,
+  GoogleServiceAccountConfig,
+  JinaAiConfig,
+  OAuthProviderConfig,
+  EmailTemplateConfig,
+  SendCloudConfig,
+  SmsTemplateBaseConfig,
+  SmsProviderConfig,
+  SmsConfig,
+  StorageCredentialsConfig,
+  StorageConfig,
+  OpenSpeechProviderConfig,
+  OpenSpeechConfig,
+  TranscodeProviderConfig,
+  TranscodeConfig,
+  TtsProviderConfig,
+  TtsConfig,
+  RiskProviderConfig,
+  RiskConfig,
+  ImageProviderConfig,
+  ImageConfig,
+  VectorProviderConfig,
+  VectorConfig,
+  MiniprogramConfig,
+} from '../validation';
+
+// Environment Configuration Types
+export type { EnvConfig } from '../validation';
+
+// ============================================================================
+// Backward-Compatible Type Aliases (保持向后兼容)
+// ============================================================================
+
+import type {
+  YamlConfig as YamlConfigType,
+  MicroServiceConfig as MicroServiceConfigType,
+  AppConfig as AppConfigType,
+  ZoneConfig as ZoneConfigType,
+  UploadConfig as UploadConfigType,
+  IpInfoConfig as IpInfoConfigType,
+  JwtConfig as JwtConfigType,
+  CryptoConfig as CryptoConfigType,
+  RedisCacheKeyConfig as RedisCacheKeyConfigType,
+  PathConfig as PathConfigType,
+  KeysConfig as KeysConfigType,
+  GoogleServiceAccountConfig as GoogleServiceAccountConfigType,
+  OAuthProviderConfig as OAuthProviderConfigType,
+  StorageCredentialsConfig as StorageCredentialsConfigType,
+  OpenSpeechConfig as OpenSpeechConfigType,
+  TranscodeConfig as TranscodeConfigType,
+  TtsConfig as TtsConfigType,
+  RiskConfig as RiskConfigType,
+  ImageConfig as ImageConfigType,
+  VectorConfig as VectorConfigType,
+  MiniprogramConfig as MiniprogramConfigType,
+} from '../validation';
+
+// ============================================================================
+// PardxApp Namespace (保持向后兼容)
+// ============================================================================
+
+export namespace PardxApp {
+  // ========================================================================
+  // API Response DTOs (非配置相关)
+  // ========================================================================
+
+  /**
+   * 分页响应数据类型（zod-first）
+   *
+   * 继承自 @repo/contracts 的 ExtendedPaginatedResponse
+   * 支持以下字段：
+   * - list: T[] - 数据列表
+   * - total: number - 总数
+   * - page?: number - 当前页码
+   * - limit?: number - 每页数量
+   * - totalSize?: number - 总大小（字节）
+   *
+   * @template T - 列表项类型
+   * @example
+   * ```typescript
+   * async getUsers(): Promise<PardxApp.PageResponseData<User>> {
+   *   return { list: users, total: 100, page: 1, limit: 20 };
+   * }
+   * ```
+   */
+  export type PageResponseData<T> = ExtendedPaginatedResponse<T>;
+
+  /**
+   * 基础分页响应类型（仅包含 list, total, page, limit）
+   * 用于简单的分页场景
+   *
+   * @template T - 列表项类型
+   */
+  export type SimplePaginatedResponse<T> = PaginatedResponse<T>;
+
+  export class Task {
+    task:
+      | Partial<SystemTaskQueue>
+      | {
+          id: string;
+          ready: boolean;
+          state: string;
+          progress?: number;
+          processing?: boolean;
+          current_step?: string;
+          estimated_remaining_time?: string;
+          processing_timestamp?: string;
+          date?: string;
+          result?: any;
+          error?: string;
+        };
+  }
+
+  // ========================================================================
+  // Configuration Type Aliases (从 Zod 推断，保持向后兼容)
+  // ========================================================================
+
+  /** @deprecated 使用 CryptoConfig from '../validation' */
+  export type Crypto = CryptoConfigType;
+
+  /** @deprecated 使用 JwtConfig from '../validation' */
+  export type JwtConfig = JwtConfigType;
+
+  /** @deprecated 使用 RedisCacheKeyConfig from '../validation' */
+  export type RedisConfig = RedisCacheKeyConfigType;
+
+  /** 完整 YAML 配置类型 - 从 Zod schema 推断 */
+  export type Config = YamlConfigType;
+
+  /** @deprecated 使用 MicroServiceConfig from '../validation' */
+  export type MicroService = MicroServiceConfigType;
+
+  /** @deprecated 使用 AppConfig from '../validation' */
+  export type LocalConfig = AppConfigType;
+
+  /** @deprecated 使用 MiniprogramConfig from '../validation' */
+  export type Miniprogram = MiniprogramConfigType;
+
+  /** @deprecated 使用 OAuthProviderConfig from '../validation' */
+  export type OauthConfig = OAuthProviderConfigType;
+
+  /** @deprecated 使用 StorageCredentialsConfig from '../validation' */
+  export type StorageSecret = StorageCredentialsConfigType;
+
+  /** @deprecated 使用 PathConfig from '../validation' */
+  export type OutOfUserPath = PathConfigType;
+
+  /** @deprecated 使用 ZoneConfig from '../validation' */
+  export type Zone = ZoneConfigType;
+
+  /** @deprecated 使用 UploadConfig from '../validation' */
+  export type Upload = UploadConfigType;
+
+  /** @deprecated 使用 TranscodeConfig from '../validation' */
+  export type Transcode = TranscodeConfigType;
+
+  /** @deprecated 使用 OpenSpeechConfig from '../validation' */
+  export type OpenSpeechConfig = OpenSpeechConfigType;
+
+  /** @deprecated 使用 TtsConfig from '../validation' */
+  export type TtsConfig = TtsConfigType;
+
+  /** @deprecated 使用 RiskConfig from '../validation' */
+  export type RiskConfig = RiskConfigType;
+
+  /** @deprecated 使用 ImageConfig from '../validation' */
+  export type ImageConfig = ImageConfigType;
+
+  /** @deprecated 使用 VectorConfig from '../validation' */
+  export type VectorConfig = VectorConfigType;
+
+  /** 完整 Keys 配置类型 - 从 Zod schema 推断 */
+  export type Keys = KeysConfigType;
+
+  /** @deprecated 使用 GoogleServiceAccountConfig from '../validation' */
+  export type GoogleKeys = GoogleServiceAccountConfigType;
+
+  /** @deprecated 使用 IpInfoConfig from '../validation' */
+  export type IpInfoConfig = IpInfoConfigType;
+
+  // ========================================================================
+  // Non-Config Types (保留原有定义)
+  // ========================================================================
+
+  export interface FileBase {
+    bucket: string;
+    key: string;
+    ext?: string;
+    env?: FileEnvType;
+    vendor?: FileBucketVendor;
+  }
+
+  export interface HeaderData {
+    platform: string;
+    os: string;
+    deviceid: string;
+    mptrail?: string;
+  }
+
+  export interface IPInfo {
+    ip: string;
+    country: string;
+    region?: string;
+    city?: string;
+    loc?: string;
+    org?: string;
+    postal?: string;
+    timezone?: string;
+  }
+
+  export interface CountryReation {
+    us: string[];
+    eu: string[];
+    ap: string[];
+    cn: string[];
+  }
+}
+
+// ============================================================================
+// Enums (非配置相关)
+// ============================================================================
+
+export enum Locale {
+  English = 'en',
+  ChineseSimplified = 'zh-CN',
+}
+
+export type LocaleString = Locale.English | Locale.ChineseSimplified;
+
+export enum VideoResolutionDto {
+  HD = '1080p',
+  SD = '720p',
+  SSD = '360p',
+  UHD = '4k',
+}

package/template/apps/api/libs/infra/common/config/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@pardx/config",
+  "version": "0.0.1",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "private": true,
+  "scripts": {
+    "build": "tsc -p tsconfig.lib.json",
+    "lint": "eslint \"src/**/*.ts\" --fix"
+  }
+}

package/template/apps/api/libs/infra/common/config/validation/env.validation.ts

@@ -0,0 +1,161 @@
+/**
+ * Environment Variables Validation Schema
+ *
+ * Validates environment variables at startup using Zod.
+ * Ensures all required configuration is present before the application starts.
+ */
+import { z } from 'zod';
+
+/**
+ * Environment variable schema definition
+ */
+export const envSchema = z.object({
+  // Environment
+  NODE_ENV: z.enum(['dev', 'test', 'prod', 'produs', 'prodap']).default('dev'),
+
+  // Project root path
+  PROJECT_ROOT: z.string().optional(),
+
+  // YAML config filename
+  YAML_CONFIG_FILENAME: z.string().default('config.local.yaml'),
+
+  // Base host for local services
+  BASE_HOST: z.string().default('127.0.0.1'),
+
+  // Database URLs
+  DATABASE_URL: z
+    .string()
+    .url()
+    .refine((url) => url.startsWith('postgresql://'), {
+      message: 'DATABASE_URL must be a PostgreSQL URL',
+    }),
+  READ_DATABASE_URL: z
+    .string()
+    .url()
+    .refine((url) => url.startsWith('postgresql://'), {
+      message: 'READ_DATABASE_URL must be a PostgreSQL URL',
+    })
+    .optional(),
+
+  // Redis URL
+  REDIS_URL: z.string().refine((url) => url.startsWith('redis://'), {
+    message: 'REDIS_URL must be a Redis URL',
+  }),
+
+  // RabbitMQ URL
+  RABBITMQ_URL: z.string().refine((url) => url.startsWith('amqp://'), {
+    message: 'RABBITMQ_URL must be an AMQP URL',
+  }),
+
+  // S3 和日志配置已迁移到 config.local.yaml -> app 节点:
+  // - enableRetryMechanism, enableEnhancedLogging, maxRetries, baseRetryDelay
+  // - nestLogOutput
+
+  // External services
+  API_BASE_URL: z.string().url().optional(),
+  INTERNAL_API_BASE_URL: z.string().url().optional(),
+});
+
+/**
+ * Type inferred from the env schema
+ */
+export type EnvConfig = z.infer<typeof envSchema>;
+
+/**
+ * Validation result type
+ */
+export interface EnvValidationResult {
+  success: boolean;
+  data?: EnvConfig;
+  errors?: z.ZodError;
+}
+
+/**
+ * Validates environment variables against the schema
+ *
+ * @returns Validated environment configuration
+ * @throws Error if validation fails in production
+ */
+export function validateEnv(): EnvConfig {
+  // Expand environment variables in values (e.g., ${BASE_HOST})
+  const expandedEnv = expandEnvVariables(process.env);
+
+  const result = envSchema.safeParse(expandedEnv);
+
+  if (!result.success) {
+    const errorMessages = result.error.errors
+      .map((err) => `  - ${err.path.join('.')}: ${err.message}`)
+      .join('\n');
+
+    console.error('❌ Environment variable validation failed:');
+    console.error(errorMessages);
+
+    // In production, throw an error to prevent startup
+    if (process.env.NODE_ENV?.startsWith('prod')) {
+      throw new Error(`Environment validation failed:\n${errorMessages}`);
+    }
+
+    // In dev, log warning but continue
+    console.warn('⚠️  Continuing with invalid environment in dev mode');
+    return expandedEnv as EnvConfig;
+  }
+
+  console.log('✅ Environment variables validated successfully');
+  return result.data;
+}
+
+/**
+ * Validates environment variables and returns detailed result
+ *
+ * @returns Validation result with success status and data or errors
+ */
+export function validateEnvSafe(): EnvValidationResult {
+  const expandedEnv = expandEnvVariables(process.env);
+  const result = envSchema.safeParse(expandedEnv);
+
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+
+  return { success: false, errors: result.error };
+}
+
+/**
+ * Expands environment variable references in values
+ * Handles patterns like ${VAR_NAME}
+ *
+ * @param env - Environment object
+ * @returns Expanded environment object
+ */
+function expandEnvVariables(
+  env: NodeJS.ProcessEnv,
+): Record<string, string | undefined> {
+  const expanded: Record<string, string | undefined> = { ...env };
+  const varPattern = /\$\{([^}]+)\}/g;
+
+  for (const key of Object.keys(expanded)) {
+    const value = expanded[key];
+    if (value && varPattern.test(value)) {
+      expanded[key] = value.replace(varPattern, (_, varName) => {
+        return expanded[varName] || process.env[varName] || '';
+      });
+    }
+  }
+
+  return expanded;
+}
+
+/**
+ * Get a single environment variable with validation
+ *
+ * @param key - Environment variable key
+ * @param defaultValue - Default value if not set
+ * @returns Environment variable value
+ */
+export function getEnvVar(key: keyof EnvConfig, defaultValue?: string): string {
+  const value = process.env[key];
+  if (value === undefined && defaultValue === undefined) {
+    throw new Error(`Environment variable ${key} is required but not set`);
+  }
+  return value ?? defaultValue ?? '';
+}