@dofe/infra-clients 0.1.1

package/dist/internal/file-cdn/dto/file-cdn.dto.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview File CDN 类型定义
+ *
+ * @module file-cdn/dto
+ */
+import { z } from 'zod';
+export declare const QueryDataSchema: z.ZodObject<{
+    auth: z.ZodString;
+}, z.core.$strip>;
+export declare const CdnConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    downloaderUrl: z.ZodString;
+    vodUrl: z.ZodString;
+    thumbTemplate: z.ZodString;
+}, z.core.$strip>;
+export declare const CdnConfigsSchema: z.ZodObject<{
+    cn: z.ZodObject<{
+        url: z.ZodString;
+        downloaderUrl: z.ZodString;
+        vodUrl: z.ZodString;
+        thumbTemplate: z.ZodString;
+    }, z.core.$strip>;
+    us: z.ZodObject<{
+        url: z.ZodString;
+        downloaderUrl: z.ZodString;
+        vodUrl: z.ZodString;
+        thumbTemplate: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const CdnUrlResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    message: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strip>;
+export declare const ImageTemplateIdSchema: z.ZodUnion<readonly [z.ZodLiteral<"origin">, z.ZodLiteral<"preview">, z.ZodLiteral<"mini">, z.ZodString]>;
+export declare const CloudFlareTemplateSchema: z.ZodUnion<readonly [z.ZodLiteral<"360:360:360:360">, z.ZodLiteral<"183:103:360:360">, z.ZodLiteral<"origin">, z.ZodLiteral<"mini">, z.ZodString]>;
+export declare const CdnRegionSchema: z.ZodEnum<{
+    cn: "cn";
+    us: "us";
+}>;
+export declare const CdnUrlTypeSchema: z.ZodEnum<{
+    image: "image";
+    video: "video";
+    download: "download";
+}>;
+export declare const SignedUrlParamsSchema: z.ZodObject<{
+    auth: z.ZodOptional<z.ZodString>;
+    expireIn: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    signature: z.ZodOptional<z.ZodString>;
+    signedHeaders: z.ZodOptional<z.ZodString>;
+    signedId: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const AwsSignatureV4ParamsSchema: z.ZodObject<{
+    algorithm: z.ZodString;
+    contentSha256: z.ZodString;
+    credential: z.ZodString;
+    expires: z.ZodNumber;
+    signature: z.ZodString;
+    signedHeaders: z.ZodString;
+    requestId: z.ZodString;
+}, z.core.$strip>;
+export type QueryData = z.infer<typeof QueryDataSchema>;
+export type CdnConfig = z.infer<typeof CdnConfigSchema>;
+export type CdnConfigs = z.infer<typeof CdnConfigsSchema>;
+export type CdnUrlResponse = z.infer<typeof CdnUrlResponseSchema>;
+export type ImageTemplateId = z.infer<typeof ImageTemplateIdSchema>;
+export type CloudFlareTemplate = z.infer<typeof CloudFlareTemplateSchema>;
+export type CdnRegion = z.infer<typeof CdnRegionSchema>;
+export type CdnUrlType = z.infer<typeof CdnUrlTypeSchema>;
+export type SignedUrlParams = z.infer<typeof SignedUrlParamsSchema>;
+export type AwsSignatureV4Params = z.infer<typeof AwsSignatureV4ParamsSchema>;
+export declare namespace DoFeFileCdn {
+    type QueryData = z.infer<typeof QueryDataSchema>;
+    type Config = z.infer<typeof CdnConfigSchema>;
+    type Configs = z.infer<typeof CdnConfigsSchema>;
+}
+//# sourceMappingURL=file-cdn.dto.d.ts.map

package/dist/internal/file-cdn/dto/file-cdn.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cdn.dto.d.ts","sourceRoot":"","sources":["../../../../src/internal/file-cdn/dto/file-cdn.dto.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;iBAE1B,CAAC;AAGH,eAAO,MAAM,eAAe;;;;;iBAK1B,CAAC;AAGH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;iBAG3B,CAAC;AAGH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAGH,eAAO,MAAM,qBAAqB,2GAKhC,CAAC;AAGH,eAAO,MAAM,wBAAwB,oJAMnC,CAAC;AAGH,eAAO,MAAM,eAAe;;;EAAuB,CAAC;AAGpD,eAAO,MAAM,gBAAgB;;;;EAAyC,CAAC;AAGvE,eAAO,MAAM,qBAAqB;;;;;;;iBAOhC,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;;;;;;iBAQrC,CAAC;AAGH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAG9E,yBAAiB,WAAW,CAAC;IAC3B,KAAY,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;IACxD,KAAY,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;IACrD,KAAY,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;CACxD"}

package/dist/internal/file-cdn/dto/file-cdn.dto.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * @fileoverview File CDN 类型定义
+ *
+ * @module file-cdn/dto
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AwsSignatureV4ParamsSchema = exports.SignedUrlParamsSchema = exports.CdnUrlTypeSchema = exports.CdnRegionSchema = exports.CloudFlareTemplateSchema = exports.ImageTemplateIdSchema = exports.CdnUrlResponseSchema = exports.CdnConfigsSchema = exports.CdnConfigSchema = exports.QueryDataSchema = void 0;
+const zod_1 = require("zod");
+// CDN Query Data Schema
+exports.QueryDataSchema = zod_1.z.object({
+    auth: zod_1.z.string(),
+});
+// CDN Config Schema
+exports.CdnConfigSchema = zod_1.z.object({
+    url: zod_1.z.string(),
+    downloaderUrl: zod_1.z.string(),
+    vodUrl: zod_1.z.string(),
+    thumbTemplate: zod_1.z.string(),
+});
+// CDN Configs Schema
+exports.CdnConfigsSchema = zod_1.z.object({
+    cn: exports.CdnConfigSchema,
+    us: exports.CdnConfigSchema,
+});
+// CDN URL Response Schema
+exports.CdnUrlResponseSchema = zod_1.z.object({
+    code: zod_1.z.number(),
+    message: zod_1.z.string(),
+    url: zod_1.z.string(),
+});
+// Image Template ID Schema
+exports.ImageTemplateIdSchema = zod_1.z.union([
+    zod_1.z.literal('origin'),
+    zod_1.z.literal('preview'),
+    zod_1.z.literal('mini'),
+    zod_1.z.string(),
+]);
+// CloudFlare Template Schema
+exports.CloudFlareTemplateSchema = zod_1.z.union([
+    zod_1.z.literal('360:360:360:360'),
+    zod_1.z.literal('183:103:360:360'),
+    zod_1.z.literal('origin'),
+    zod_1.z.literal('mini'),
+    zod_1.z.string(),
+]);
+// CDN Region Schema
+exports.CdnRegionSchema = zod_1.z.enum(['cn', 'us']);
+// CDN URL Type Schema
+exports.CdnUrlTypeSchema = zod_1.z.enum(['image', 'video', 'download']);
+// Signed URL Params Schema
+exports.SignedUrlParamsSchema = zod_1.z.object({
+    auth: zod_1.z.string().optional(),
+    expireIn: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
+    signature: zod_1.z.string().optional(),
+    signedHeaders: zod_1.z.string().optional(),
+    signedId: zod_1.z.string().optional(),
+    templateId: zod_1.z.string().optional(),
+});
+// AWS Signature V4 Params Schema
+exports.AwsSignatureV4ParamsSchema = zod_1.z.object({
+    algorithm: zod_1.z.string(),
+    contentSha256: zod_1.z.string(),
+    credential: zod_1.z.string(),
+    expires: zod_1.z.number(),
+    signature: zod_1.z.string(),
+    signedHeaders: zod_1.z.string(),
+    requestId: zod_1.z.string(),
+});
+//# sourceMappingURL=file-cdn.dto.js.map

package/dist/internal/file-cdn/dto/file-cdn.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cdn.dto.js","sourceRoot":"","sources":["../../../../src/internal/file-cdn/dto/file-cdn.dto.ts"],"names":[],"mappings":"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"}

package/dist/internal/file-cdn/file-cdn-client.service.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-cdn-client.service.spec.d.ts.map

package/dist/internal/file-cdn/file-cdn-client.service.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cdn-client.service.spec.d.ts","sourceRoot":"","sources":["../../../src/internal/file-cdn/file-cdn-client.service.spec.ts"],"names":[],"mappings":""}

package/dist/internal/file-cdn/file-cdn-client.service.spec.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const testing_1 = require("@nestjs/testing");
+const file_cdn_client_1 = require("./file-cdn.client");
+describe('FileCdnClient', () => {
+    let service;
+    beforeEach(async () => {
+        const module = await testing_1.Test.createTestingModule({
+            providers: [file_cdn_client_1.FileCdnClient],
+        }).compile();
+        service = module.get(file_cdn_client_1.FileCdnClient);
+    });
+    it('should be defined', () => {
+        expect(service).toBeDefined();
+    });
+});
+//# sourceMappingURL=file-cdn-client.service.spec.js.map

package/dist/internal/file-cdn/file-cdn-client.service.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cdn-client.service.spec.js","sourceRoot":"","sources":["../../../src/internal/file-cdn/file-cdn-client.service.spec.ts"],"names":[],"mappings":";;AAAA,6CAAsD;AACtD,uDAAkD;AAElD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,OAAsB,CAAC;IAE3B,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,MAAM,GAAkB,MAAM,cAAI,CAAC,mBAAmB,CAAC;YAC3D,SAAS,EAAE,CAAC,+BAAa,CAAC;SAC3B,CAAC,CAAC,OAAO,EAAE,CAAC;QAEb,OAAO,GAAG,MAAM,CAAC,GAAG,CAAgB,+BAAa,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/internal/file-cdn/file-cdn.client.d.ts

@@ -0,0 +1,283 @@
+/**
+ * @fileoverview File CDN 客户端
+ *
+ * 本文件实现了 CDN URL 生成服务，负责：
+ * - 生成图片 CDN URL（火山引擎、CloudFlare）
+ * - 生成视频点播 URL
+ * - 生成文件下载 URL
+ * - 处理 CDN 签名和认证
+ *
+ * @module file-cdn/client
+ */
+import { Logger } from 'winston';
+import { ConfigService } from '@nestjs/config';
+import { FileBucketVendor } from '@prisma/client';
+import { FileStorageService } from '@dofe/infra-shared-services';
+import { CryptClient } from '@dofe/infra-clients';
+import { CdnUrlResponse, ImageTemplateId, CloudFlareTemplate } from './dto/file-cdn.dto';
+/**
+ * File CDN 客户端
+ *
+ * @description 提供 CDN URL 生成服务，支持多种 CDN 供应商和 URL 类型。
+ *
+ * 主要功能：
+ * - **图片 CDN**: 火山引擎图片处理、CloudFlare 图片优化
+ * - **视频 CDN**: 视频点播 URL 生成
+ * - **下载 CDN**: 文件下载 URL 生成
+ *
+ * 安全特性：
+ * - 支持 AWS 签名 V4 认证
+ * - 支持 URL 签名验证
+ * - 私有文件访问控制
+ *
+ * @class FileCdnClient
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class ImageService {
+ *   constructor(private readonly cdnClient: FileCdnClient) {}
+ *
+ *   // 获取图片 CDN URL
+ *   async getImageUrl(vendor: FileBucketVendor, bucket: string, key: string) {
+ *     return await this.cdnClient.getImageVolcengineCdn(
+ *       vendor,
+ *       bucket,
+ *       key,
+ *       'mini',
+ *     );
+ *   }
+ *
+ *   // 获取视频 URL
+ *   async getVideoUrl(vendor: FileBucketVendor, bucket: string, key: string) {
+ *     return await this.cdnClient.getVodUrl(vendor, bucket, key);
+ *   }
+ * }
+ * ```
+ */
+export declare class FileCdnClient {
+    private readonly fileApi;
+    private readonly crypt;
+    private readonly logger;
+    /**
+     * CDN 配置
+     * @private
+     */
+    private readonly cdnConfig;
+    /**
+     * 构造函数
+     *
+     * @param {ConfigService} config - NestJS 配置服务
+     * @param {FileStorageService} fileApi - 文件存储服务
+     * @param {CryptClient} crypt - 加密服务
+     * @param {Logger} logger - Winston 日志记录器
+     */
+    constructor(config: ConfigService, fileApi: FileStorageService, crypt: CryptClient, logger: Logger);
+    /**
+     * 获取文件下载 URL
+     *
+     * @description 生成文件下载器的 CDN URL，支持公开和私有文件。
+     *
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {string} bucket - 存储桶名称
+     * @param {string} key - 文件键
+     * @returns {Promise<string>} CDN 下载 URL
+     *
+     * @example
+     * ```typescript
+     * const url = await cdnClient.getDownloaderUrl('oss', 'my-bucket', 'files/doc.pdf');
+     * // 返回: "https://cdn.example.com/signed-url..."
+     * ```
+     */
+    getDownloaderUrl(vendor: FileBucketVendor, bucket: string, key: string): Promise<string>;
+    /**
+     * 获取视频点播 URL
+     *
+     * @description 生成视频点播的 CDN URL，支持公开和私有视频。
+     *
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {string} bucket - 存储桶名称
+     * @param {string} key - 视频文件键
+     * @returns {Promise<string>} CDN 视频 URL
+     *
+     * @example
+     * ```typescript
+     * const url = await cdnClient.getVodUrl('tos', 'video-bucket', 'videos/movie.mp4');
+     * // 返回: "https://vod.example.com/signed-url..."
+     * ```
+     */
+    getVodUrl(vendor: FileBucketVendor, bucket: string, key: string): Promise<string>;
+    /**
+     * 获取火山引擎图片 CDN URL
+     *
+     * @description 生成火山引擎图片处理的 CDN URL，支持多种图片模板。
+     *
+     * 支持的模板：
+     * - `origin`: 原图预览
+     * - `preview`: 预览图
+     * - `mini`: 缩略图
+     * - 自定义尺寸: `183:103:360:360` 格式
+     *
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {string} bucket - 存储桶名称
+     * @param {string} key - 图片文件键
+     * @param {ImageTemplateId} [templateId='183:103:360:360'] - 图片模板 ID
+     * @returns {Promise<string>} CDN 图片 URL
+     *
+     * @example
+     * ```typescript
+     * // 获取缩略图
+     * const miniUrl = await cdnClient.getImageVolcengineCdn(
+     *   'tos',
+     *   'image-bucket',
+     *   'images/photo.jpg',
+     *   'mini',
+     * );
+     *
+     * // 获取自定义尺寸
+     * const customUrl = await cdnClient.getImageVolcengineCdn(
+     *   'tos',
+     *   'image-bucket',
+     *   'images/photo.jpg',
+     *   '640:480:640:480',
+     * );
+     * ```
+     */
+    getImageVolcengineCdn(vendor: FileBucketVendor, bucket: string, key: string, templateId?: ImageTemplateId): Promise<string>;
+    /**
+     * 获取 CloudFlare 图片 CDN URL
+     *
+     * @description 生成 CloudFlare 图片优化的 CDN URL。
+     *
+     * 支持的模板：
+     * - `360:360:360:360`: 360x360 裁剪
+     * - `183:103:360:360`: 320x180 裁剪
+     * - `origin`: 原图
+     * - `mini`: 360x360 包含
+     *
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {string} bucket - 存储桶名称
+     * @param {string} key - 图片文件键
+     * @param {CloudFlareTemplate} [templateId='183:103:360:360'] - CloudFlare 模板
+     * @returns {Promise<string>} CDN 图片 URL
+     *
+     * @example
+     * ```typescript
+     * const url = await cdnClient.getImageCloudFlareCdnUrl(
+     *   'oss',
+     *   'image-bucket',
+     *   'images/photo.jpg',
+     *   'mini',
+     * );
+     * ```
+     */
+    getImageCloudFlareCdnUrl(vendor: FileBucketVendor, bucket: string, key: string, templateId?: CloudFlareTemplate): Promise<string>;
+    /**
+     * 获取原始 CDN 图片（带验证）
+     *
+     * @description 验证签名后返回原始图片 URL，用于 CDN 回源。
+     *
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {string} bucket - 存储桶名称
+     * @param {string} key - 图片文件键
+     * @param {string} [auth] - 认证信息
+     * @param {string} [expireIn] - 过期时间
+     * @param {string} [signature] - 签名
+     * @param {string} [signedHeaders] - 签名头
+     * @param {string} [signedId] - 签名 ID
+     * @param {string} [templateId='183:103:360:360'] - 模板 ID
+     * @returns {Promise<CdnUrlResponse>} CDN URL 响应
+     *
+     * @example
+     * ```typescript
+     * const response = await cdnClient.getCdnOriginImages(
+     *   'tos',
+     *   'bucket',
+     *   'key',
+     *   auth,
+     *   expireIn,
+     *   signature,
+     *   signedHeaders,
+     *   signedId,
+     * );
+     *
+     * if (response.code === 200) {
+     *   console.log('Origin URL:', response.url);
+     * }
+     * ```
+     */
+    getCdnOriginImages(vendor: FileBucketVendor, bucket: string, key: string, auth?: string, expireIn?: string, signature?: string, signedHeaders?: string, signedId?: string, templateId?: string): Promise<CdnUrlResponse>;
+    /**
+     * 构建 URI 路径
+     *
+     * @private
+     */
+    private buildUri;
+    /**
+     * 构建公开 URL
+     *
+     * @private
+     */
+    private buildPublicUrl;
+    /**
+     * 构建私有 URL（带 AWS 签名 V4）
+     *
+     * @private
+     */
+    private buildPrivateUrl;
+    /**
+     * 构建私有图片 URL
+     *
+     * @private
+     */
+    private buildPrivateImageUrl;
+    /**
+     * 构建 CloudFlare 私有 URL
+     *
+     * @private
+     */
+    private buildCloudFlarePrivateUrl;
+    /**
+     * 构建 AWS 签名 URL
+     *
+     * @private
+     */
+    private buildAwsSignedUrl;
+    /**
+     * 生成签名
+     *
+     * @private
+     */
+    private generateSignature;
+    /**
+     * 获取火山引擎图片模板
+     *
+     * @private
+     */
+    private getVolcengineTemplate;
+    /**
+     * 获取 CloudFlare 图片模板
+     *
+     * @private
+     */
+    private getCloudFlareTemplate;
+    /**
+     * 验证签名
+     *
+     * @private
+     */
+    private validateSignature;
+    /**
+     * 创建禁止访问响应
+     *
+     * @private
+     */
+    private createForbiddenResponse;
+    /**
+     * 创建成功响应
+     *
+     * @private
+     */
+    private createSuccessResponse;
+}
+//# sourceMappingURL=file-cdn.client.d.ts.map

package/dist/internal/file-cdn/file-cdn.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cdn.client.d.ts","sourceRoot":"","sources":["../../../src/internal/file-cdn/file-cdn.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAEL,cAAc,EACd,eAAe,EACf,kBAAkB,EAEnB,MAAM,oBAAoB,CAAC;AAuD5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBACa,aAAa;IAiBtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACW,OAAO,CAAC,QAAQ,CAAC,MAAM;IAlB1D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAEhD;;;;;;;OAOG;gBAED,MAAM,EAAE,aAAa,EACJ,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,WAAW,EACe,MAAM,EAAE,MAAM;IASlE;;;;;;;;;;;;;;;OAeG;IACG,gBAAgB,CACpB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC;IAelB;;;;;;;;;;;;;;;OAeG;IACG,SAAS,CACb,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC;IAelB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,qBAAqB,CACzB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,eAAmC,GAC9C,OAAO,CAAC,MAAM,CAAC;IAsBlB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,wBAAwB,CAC5B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,kBAAsC,GACjD,OAAO,CAAC,MAAM,CAAC;IAgBlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,kBAAkB,CACtB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,GAAE,MAA0B,GACrC,OAAO,CAAC,cAAc,CAAC;IAiD1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAItB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAYjC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;CAO9B"}