meeglesdk 0.1.0

package/dist/core/base-service.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Service 基类
+ * 提供通用的请求方法封装
+ */
+import type { RequestHandler, AuthContext, RetryConfig, DownloadProgress, ResponseValidator } from './request.js';
+import type { PaginatedResult, PaginatedObjectResult } from '../types/common.js';
+/** 请求选项 */
+export interface ServiceRequestOptions<T = unknown> {
+    /** 路径参数 */
+    pathParams?: Record<string, string>;
+    /** 查询参数 */
+    query?: Record<string, unknown>;
+    /** 认证上下文 */
+    auth?: AuthContext;
+    /** 幂等键 */
+    idempotencyKey?: string;
+    /** 超时（毫秒） */
+    timeout?: number;
+    /** 跳过重试 */
+    skipRetry?: boolean;
+    /** 重试配置（可选，覆盖默认配置） */
+    retry?: Partial<RetryConfig>;
+    /** 响应数据校验（可选）。分页请求中将应用于每个元素 */
+    responseValidator?: ResponseValidator<T>;
+}
+/** 上传请求选项 */
+export interface UploadRequestOptions<T = unknown> extends ServiceRequestOptions<T> {
+    /** 上传文件大小上限（字节），默认 100,000,000 */
+    maxUploadSizeBytes?: number;
+    /** 上传文件大小下限（字节），默认 1 */
+    minUploadSizeBytes?: number;
+}
+/** 文件上传选项 */
+export interface UploadOptions<T = unknown> {
+    /** 路径参数 */
+    pathParams?: Record<string, string>;
+    /** 文件数据 */
+    file: Blob | File | Buffer;
+    /** 文件名 */
+    fileName: string;
+    /** 表单字段名 (默认 'file') */
+    fieldName?: string;
+    /** 额外的表单字段 */
+    formFields?: Record<string, string>;
+    /** 认证上下文 */
+    auth?: AuthContext;
+    /** 超时（毫秒） */
+    timeout?: number;
+    /** 上传文件大小上限（字节），默认 100,000,000 */
+    maxUploadSizeBytes?: number;
+    /** 上传文件大小下限（字节），默认 1 */
+    minUploadSizeBytes?: number;
+    /** 跳过重试 */
+    skipRetry?: boolean;
+    /** 重试配置（可选，覆盖默认配置） */
+    retry?: Partial<RetryConfig>;
+    /** 响应数据校验（可选） */
+    responseValidator?: ResponseValidator<T>;
+}
+/** 文件下载选项 */
+export interface DownloadOptions {
+    /** 路径参数 */
+    pathParams?: Record<string, string>;
+    /** 请求体 */
+    body?: unknown;
+    /** 认证上下文 */
+    auth?: AuthContext;
+    /** 超时（毫秒） */
+    timeout?: number;
+    /** 取消信号 */
+    signal?: AbortSignal;
+    /** 下载进度回调 */
+    onProgress?: (progress: DownloadProgress) => void;
+    /** 分块回调（流式下载时可用于写文件） */
+    onChunk?: (chunk: Uint8Array, progress: DownloadProgress) => void;
+    /** 跳过重试 */
+    skipRetry?: boolean;
+    /** 重试配置（可选，覆盖默认配置） */
+    retry?: Partial<RetryConfig>;
+}
+/**
+ * Service 基类
+ */
+export declare abstract class BaseService {
+    protected readonly requestHandler: RequestHandler;
+    constructor(requestHandler: RequestHandler);
+    /**
+     * GET 请求
+     */
+    protected get<T>(path: string, options?: ServiceRequestOptions<T>): Promise<T>;
+    /**
+     * POST 请求
+     */
+    protected post<T>(path: string, body?: unknown, options?: ServiceRequestOptions<T>): Promise<T>;
+    /**
+     * PUT 请求
+     */
+    protected put<T>(path: string, body?: unknown, options?: ServiceRequestOptions<T>): Promise<T>;
+    /**
+     * PATCH 请求
+     */
+    protected patch<T>(path: string, body?: unknown, options?: ServiceRequestOptions<T>): Promise<T>;
+    /**
+     * DELETE 请求
+     */
+    protected delete<T>(path: string, options?: ServiceRequestOptions<T>): Promise<T>;
+    /**
+     * DELETE 请求（带请求体）
+     */
+    protected deleteWithBody<T>(path: string, body?: unknown, options?: ServiceRequestOptions<T>): Promise<T>;
+    /**
+     * GET 分页请求
+     * 用于 pagination 与 data 同级的接口
+     */
+    protected getPaginated<T>(path: string, options?: ServiceRequestOptions<T>): Promise<PaginatedResult<T>>;
+    /**
+     * POST 分页请求
+     * 用于 pagination 与 data 同级的接口
+     */
+    protected postPaginated<T>(path: string, body?: unknown, options?: ServiceRequestOptions<T>): Promise<PaginatedResult<T>>;
+    /**
+     * GET 分页请求（data 为对象）
+     * 用于 pagination 与 data 同级，但 data 为对象的接口
+     */
+    protected getWithPagination<T>(path: string, options?: ServiceRequestOptions<T>): Promise<PaginatedObjectResult<T>>;
+    /**
+     * POST 分页请求（data 为对象）
+     * 用于 pagination 与 data 同级，但 data 为对象的接口
+     */
+    protected postWithPagination<T>(path: string, body?: unknown, options?: ServiceRequestOptions<T>): Promise<PaginatedObjectResult<T>>;
+    /**
+     * GET 请求（自定义响应字段）
+     */
+    protected getWithResponseKey<T>(path: string, responseKey: string, options?: ServiceRequestOptions<T>): Promise<T>;
+    /**
+     * POST 请求（自定义响应字段）
+     */
+    protected postWithResponseKey<T>(path: string, responseKey: string, body?: unknown, options?: ServiceRequestOptions<T>): Promise<T>;
+    /**
+     * 执行请求
+     */
+    private doRequest;
+    /**
+     * 上传文件
+     */
+    protected upload<T>(path: string, options: UploadOptions<T>): Promise<T>;
+    /**
+     * 下载文件
+     */
+    protected download(path: string, options?: DownloadOptions): Promise<ArrayBuffer>;
+    /**
+     * 下载文件（流式）
+     */
+    protected downloadStream(path: string, options?: DownloadOptions): Promise<ReadableStream<Uint8Array>>;
+}
+//# sourceMappingURL=base-service.d.ts.map

package/dist/core/base-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-service.d.ts","sourceRoot":"","sources":["../../src/core/base-service.ts"],"names":[],"mappings":"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"}

package/dist/core/base-service.js

@@ -0,0 +1,240 @@
+/**
+ * Service 基类
+ * 提供通用的请求方法封装
+ */
+/**
+ * Service 基类
+ */
+export class BaseService {
+    requestHandler;
+    constructor(requestHandler) {
+        this.requestHandler = requestHandler;
+    }
+    /**
+     * GET 请求
+     */
+    get(path, options) {
+        return this.doRequest('GET', path, undefined, options);
+    }
+    /**
+     * POST 请求
+     */
+    post(path, body, options) {
+        return this.doRequest('POST', path, body, options);
+    }
+    /**
+     * PUT 请求
+     */
+    put(path, body, options) {
+        return this.doRequest('PUT', path, body, options);
+    }
+    /**
+     * PATCH 请求
+     */
+    patch(path, body, options) {
+        return this.doRequest('PATCH', path, body, options);
+    }
+    /**
+     * DELETE 请求
+     */
+    delete(path, options) {
+        return this.doRequest('DELETE', path, undefined, options);
+    }
+    /**
+     * DELETE 请求（带请求体）
+     */
+    deleteWithBody(path, body, options) {
+        return this.requestHandler.request({
+            method: 'DELETE',
+            path,
+            body,
+            pathParams: options?.pathParams,
+            query: options?.query,
+            auth: options?.auth,
+            idempotencyKey: options?.idempotencyKey,
+            timeout: options?.timeout,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        });
+    }
+    /**
+     * GET 分页请求
+     * 用于 pagination 与 data 同级的接口
+     */
+    getPaginated(path, options) {
+        return this.requestHandler.requestPaginated({
+            method: 'GET',
+            path,
+            pathParams: options?.pathParams,
+            query: options?.query,
+            auth: options?.auth,
+            timeout: options?.timeout,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        });
+    }
+    /**
+     * POST 分页请求
+     * 用于 pagination 与 data 同级的接口
+     */
+    postPaginated(path, body, options) {
+        return this.requestHandler.requestPaginated({
+            method: 'POST',
+            path,
+            body,
+            pathParams: options?.pathParams,
+            query: options?.query,
+            auth: options?.auth,
+            idempotencyKey: options?.idempotencyKey,
+            timeout: options?.timeout,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        });
+    }
+    /**
+     * GET 分页请求（data 为对象）
+     * 用于 pagination 与 data 同级，但 data 为对象的接口
+     */
+    getWithPagination(path, options) {
+        return this.requestHandler.requestWithPagination({
+            method: 'GET',
+            path,
+            pathParams: options?.pathParams,
+            query: options?.query,
+            auth: options?.auth,
+            timeout: options?.timeout,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        });
+    }
+    /**
+     * POST 分页请求（data 为对象）
+     * 用于 pagination 与 data 同级，但 data 为对象的接口
+     */
+    postWithPagination(path, body, options) {
+        return this.requestHandler.requestWithPagination({
+            method: 'POST',
+            path,
+            body,
+            pathParams: options?.pathParams,
+            query: options?.query,
+            auth: options?.auth,
+            idempotencyKey: options?.idempotencyKey,
+            timeout: options?.timeout,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        });
+    }
+    /**
+     * GET 请求（自定义响应字段）
+     */
+    getWithResponseKey(path, responseKey, options) {
+        return this.requestHandler.requestWithResponseKey({
+            method: 'GET',
+            path,
+            pathParams: options?.pathParams,
+            query: options?.query,
+            auth: options?.auth,
+            timeout: options?.timeout,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        }, responseKey);
+    }
+    /**
+     * POST 请求（自定义响应字段）
+     */
+    postWithResponseKey(path, responseKey, body, options) {
+        return this.requestHandler.requestWithResponseKey({
+            method: 'POST',
+            path,
+            body,
+            pathParams: options?.pathParams,
+            query: options?.query,
+            auth: options?.auth,
+            idempotencyKey: options?.idempotencyKey,
+            timeout: options?.timeout,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        }, responseKey);
+    }
+    /**
+     * 执行请求
+     */
+    doRequest(method, path, body, options) {
+        return this.requestHandler.request({
+            method,
+            path,
+            body,
+            pathParams: options?.pathParams,
+            query: options?.query,
+            auth: options?.auth,
+            idempotencyKey: options?.idempotencyKey,
+            timeout: options?.timeout,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        });
+    }
+    /**
+     * 上传文件
+     */
+    upload(path, options) {
+        return this.requestHandler.upload({
+            path,
+            pathParams: options.pathParams,
+            file: options.file,
+            fileName: options.fileName,
+            fieldName: options.fieldName,
+            formFields: options.formFields,
+            auth: options.auth,
+            timeout: options.timeout,
+            maxUploadSizeBytes: options.maxUploadSizeBytes,
+            minUploadSizeBytes: options.minUploadSizeBytes,
+            skipRetry: options.skipRetry,
+            retry: options.retry,
+            responseValidator: options.responseValidator,
+        });
+    }
+    /**
+     * 下载文件
+     */
+    download(path, options) {
+        return this.requestHandler.download({
+            path,
+            pathParams: options?.pathParams,
+            body: options?.body,
+            auth: options?.auth,
+            timeout: options?.timeout,
+            signal: options?.signal,
+            onProgress: options?.onProgress,
+            onChunk: options?.onChunk,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+        });
+    }
+    /**
+     * 下载文件（流式）
+     */
+    downloadStream(path, options) {
+        return this.requestHandler.downloadStream({
+            path,
+            pathParams: options?.pathParams,
+            body: options?.body,
+            auth: options?.auth,
+            timeout: options?.timeout,
+            signal: options?.signal,
+            onProgress: options?.onProgress,
+            onChunk: options?.onChunk,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+        });
+    }
+}
+//# sourceMappingURL=base-service.js.map

package/dist/core/base-service.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,181 @@
+/**
+ * 错误处理
+ * 100% 参考 Meego API 文档: Meego-API-docs/common/Open API 错误码.md
+ */
+import type { ErrorDetail } from '../types/common.js';
+/**
+ * 错误码常量
+ * 参考: Meego-API-docs/common/Open API 错误码.md
+ */
+export declare const ErrorCodes: {
+    readonly NO_PERMISSION: 10001;
+    readonly ILLEGAL_OPERATION: 10002;
+    readonly OPERATION_FAILED: 10004;
+    readonly TOKEN_NOT_EXIST: 10021;
+    readonly CHECK_TOKEN_FAILED: 10022;
+    readonly CHECK_TOKEN_PERM_FAILED: 10301;
+    readonly USER_RESIGNED: 10302;
+    readonly CODE_INVALID: 10210;
+    readonly TOKEN_INFO_INVALID: 10211;
+    readonly NO_PROJECT_PERMISSION: 10404;
+    readonly API_REQUEST_FREQUENCY_LIMIT: 10429;
+    readonly API_REQUEST_IDEMPOTENT_LIMIT: 10430;
+    readonly PARAM_REQUEST_LIMIT: 20001;
+    readonly PAGE_SIZE_LIMIT: 20002;
+    readonly WRONG_WORKITEM_TYPE_PARAM: 20003;
+    readonly SEARCH_USER_LIMIT: 20004;
+    readonly MISSING_PARAM: 20005;
+    readonly INVALID_PARAM: 20006;
+    readonly WORKITEM_ALREADY_ABORTED: 20007;
+    readonly WORKITEM_ALREADY_RESTORED: 20008;
+    readonly ABORT_OR_RESTORE_NO_REASON: 20009;
+    readonly WORKITEM_TYPE_NOT_SAME: 20010;
+    readonly INPUT_VIEW_NOT_FIX_VIEW: 20011;
+    readonly VIEW_NOT_IN_PROJECT: 20012;
+    readonly INVALID_TIME_INTERVAL: 20013;
+    readonly PROJECT_WORKITEM_NOT_MATCH: 20014;
+    readonly FIELD_MIX_ERROR: 20015;
+    readonly NODE_NOT_ARRIVED: 20016;
+    readonly NODE_ALREADY_COMPLETED: 20017;
+    readonly NODE_ID_NOT_EXIST: 20018;
+    readonly UPLOADED_FILE_SIZE_LIMIT: 20024;
+    readonly FIELD_KEY_ALIAS_MISSING: 20025;
+    readonly FLOWTYPE_ERROR_STATUS: 20026;
+    readonly FLOWTYPE_ERROR_NODE: 20027;
+    readonly WORKITEM_IDS_LIMIT: 20028;
+    readonly UNSUPPORTED_FIELD_TYPE: 20029;
+    readonly DIFFERENT_SCHEDULE_SET_OWNER_INVALID: 20032;
+    readonly UPDATE_FIELD_INVALID: 20033;
+    readonly NODE_NOT_COMPLETED_ROLLBACK: 20037;
+    readonly REQUIRED_FIELD_NOT_SET: 20038;
+    readonly PLUGIN_TOKEN_MUST_HAVE_USER_KEY: 20039;
+    readonly REQUEST_FORM_NULL: 20040;
+    readonly ROLE_OWNER_MUST_SET: 20041;
+    readonly X_USER_KEY_WRONG: 20042;
+    readonly VIEW_IDS_LIMIT: 20043;
+    readonly WORKITEM_DISABLED: 20044;
+    readonly COMMENT_WORKITEM_NOT_MATCH: 20045;
+    readonly TASK_ID_NOT_EXIST: 20046;
+    readonly ROLE_ASSIGNEE_ASSIGNEE_CONFLICT: 20047;
+    readonly ROLE_ASSIGNEE_ROLE_NOT_MATCH: 20048;
+    readonly SEARCH_RESULT_TOO_LARGE: 20055;
+    readonly ONLY_WORKFLOW_MODE_ABORT: 20056;
+    readonly SEARCH_PROJECT_LIMIT: 20057;
+    readonly SEARCH_USER_ROLE_FIELDKEY_ERROR: 20058;
+    readonly SEARCH_USER_KEYS_REQUIRED: 20059;
+    readonly SEARCH_OPERATOR_ERROR: 20063;
+    readonly SEARCH_OPTION_SIZE_LIMIT: 20064;
+    readonly SEARCH_PARAM_NOT_SUPPORT_STATEFLOW: 20065;
+    readonly SEARCH_SIGNAL_LEN_ERROR: 20066;
+    readonly SEARCH_SIGNAL_VALUE_NOT_SUPPORT: 20067;
+    readonly SEARCH_PARAM_NOT_SUPPORT: 20068;
+    readonly SEARCH_PARAM_VALUE_ERROR: 20069;
+    readonly FIELD_INVALID: 20070;
+    readonly SEARCH_PEOPLE_NOT_SUPPORT_ISSUE: 20071;
+    readonly CONJUNCTION_VALUE_ERROR: 20072;
+    readonly QUERY_LENGTH_ERROR: 20080;
+    readonly QUERY_TYPE_NOT_SUPPORTED: 20081;
+    readonly ACTION_NOT_SUPPORTED: 20082;
+    readonly DUPLICATION_FIELD: 20083;
+    readonly REQUEST_INTERCEPTED: 20090;
+    readonly INVALID_PARAM_9999: 9999;
+    readonly COMMERCIAL_USAGE_EXCEEDED: 1000051942;
+    readonly UPLOAD_FILE_SIZE_LIMIT_100M: 1000050174;
+    readonly WORKITEM_NOT_FOUND: 30005;
+    readonly USER_NOT_FOUND: 30006;
+    readonly WORKFLOW_NOT_FOUND: 30007;
+    readonly BUSINESS_NOT_FOUND: 30008;
+    readonly FIELD_NOT_FOUND: 30009;
+    readonly STATEFLOW_NOT_FOUND: 30010;
+    readonly NODE_NOT_FOUND_IN_WORKFLOW: 30011;
+    readonly STATE_NOT_FOUND_IN_STATEFLOW: 30012;
+    readonly VIEW_NOT_EXIST: 13001;
+    readonly RECORD_NOT_FOUND: 30015;
+    readonly RPC_CALL_ERROR: 50006;
+};
+/**
+ * Meego API 错误
+ */
+export declare class MeegoError extends Error {
+    /** 错误码 */
+    readonly errCode: number;
+    /** 错误信息 */
+    readonly errMsg: string;
+    /** 错误详情 */
+    readonly detail?: ErrorDetail;
+    /** HTTP 状态码 */
+    readonly httpStatus?: number;
+    constructor(message: string, errCode: number, errMsg: string, detail?: ErrorDetail, httpStatus?: number);
+    /**
+     * 是否为认证错误 (Token 相关)
+     * 10021: Token Not Exist
+     * 10022: Check Token Failed
+     * 10301: Check Token Perm Failed
+     */
+    get isAuthError(): boolean;
+    /**
+     * 是否为权限错误
+     * 10001: No Permission
+     * 10002: Illegal Operation
+     * 10404: No Project Permission
+     */
+    get isPermissionError(): boolean;
+    /**
+     * 是否为资源未找到错误
+     * 30005: WorkItem Not Found
+     * 30006: User Not Found
+     * 30009: Field Not Found
+     * 13001: View Not Exist
+     */
+    get isNotFoundError(): boolean;
+    /**
+     * 是否为频率限制错误
+     * 10429: API Request Frequency Limit (15 QPS)
+     * 10430: API Request Idempotent Limit
+     */
+    get isRateLimitError(): boolean;
+    /**
+     * 是否可重试
+     * 10429: 频率限制，可以稍后重试
+     * 50006: RPC Call Error / 服务瞬时超载
+     */
+    get isRetryable(): boolean;
+    /**
+     * 是否为参数错误
+     */
+    get isParamError(): boolean;
+    /**
+     * 获取 log_id (用于追踪)
+     */
+    get logId(): string | undefined;
+    /**
+     * 转换为 JSON
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * 认证错误（用于认证接口）
+ */
+export declare class MeegoAuthError extends MeegoError {
+    constructor(code: number, msg: string);
+}
+/**
+ * 网络错误
+ */
+export declare class MeegoNetworkError extends Error {
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+/**
+ * 超时错误
+ */
+export declare class MeegoTimeoutError extends MeegoNetworkError {
+    constructor(timeout: number);
+}
+/**
+ * 主动取消错误
+ */
+export declare class MeegoAbortError extends MeegoNetworkError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkGb,CAAC;AAEX;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,UAAU;IACV,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,WAAW;IACX,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,WAAW;IACX,SAAgB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrC,eAAe;IACf,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,MAAM;IAarB;;;;;OAKG;IACH,IAAI,WAAW,IAAI,OAAO,CAMzB;IAED;;;;;OAKG;IACH,IAAI,iBAAiB,IAAI,OAAO,CAM/B;IAED;;;;;;OAMG;IACH,IAAI,eAAe,IAAI,OAAO,CAY7B;IAED;;;;OAIG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAK9B;IAED;;;;OAIG;IACH,IAAI,WAAW,IAAI,OAAO,CAKzB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlC;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;gBAChC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAKtC;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB;gBAC1C,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;gBACxC,OAAO,SAAoB;CAKxC"}