@exabugs/dynamodb-client 0.1.0

package/dist/server/operations/updateMany.js

@@ -0,0 +1,316 @@
+/**
+ * updateMany 操作
+ * 複数レコードを一括更新する（JSON Merge Patch形式）
+ *
+ * 要件: 4.2, 4.4, 5.2, 5.3, 7.4, 13.1, 13.2, 13.3, 13.8, 13.12
+ */
+import { BatchGetCommand, TransactWriteCommand } from '@aws-sdk/lib-dynamodb';
+import { createLogger, generateShadowRecords, getResourceSchema, getShadowConfig, } from '../../index.js';
+import { calculateShadowDiff, generateMainRecordSK } from '../shadow/index.js';
+import { calculateTimeoutRisk, logBulkOperationComplete, logLargeBatchWarning, logPartialFailure, logPreparationTimeoutRisk, } from '../utils/bulkOperations.js';
+import { calculateChunks, executeChunks } from '../utils/chunking.js';
+import { executeDynamoDBOperation, getDBClient, getTableName, removeShadowKeys, } from '../utils/dynamodb.js';
+import { addUpdateTimestamp } from '../utils/timestamps.js';
+const logger = createLogger({ service: 'records-lambda' });
+/**
+ * JSON Merge Patch (RFC 7396) を適用する
+ *
+ * @param target - 対象オブジェクト
+ * @param patch - パッチオブジェクト
+ * @returns マージされたオブジェクト
+ */
+function applyJsonMergePatch(target, patch) {
+    const result = { ...target };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete result[key];
+        }
+        else if (typeof value === 'object' &&
+            !Array.isArray(value) &&
+            value !== null &&
+            typeof result[key] === 'object' &&
+            !Array.isArray(result[key]) &&
+            result[key] !== null) {
+            result[key] = applyJsonMergePatch(result[key], value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * updateMany 操作を実行する
+ *
+ * 処理フロー:
+ * 1. BatchGetItemで既存レコードを取得
+ * 2. 各レコードにJSON Merge Patchを適用
+ * 3. updatedAtタイムスタンプを更新
+ * 4. 新しいシャドーSKを生成し、差分を計算
+ * 5. アイテム数を計算してチャンク分割（1 + 削除シャドー数 + 追加シャドー数）
+ * 6. 各チャンクをTransactWriteItemsで順次実行
+ * 7. 部分失敗をハンドリング
+ *
+ * @param resource - リソース名
+ * @param params - updateManyパラメータ
+ * @param requestId - リクエストID
+ * @returns 更新結果（成功レコード、失敗ID、エラー情報）
+ */
+export async function handleUpdateMany(resource, params, requestId) {
+    const { ids, data: patchData } = params;
+    const startTime = Date.now();
+    logger.debug('Executing updateMany', {
+        requestId,
+        resource,
+        count: ids.length,
+    });
+    // IDが空の場合は空レスポンスを返す
+    if (ids.length === 0) {
+        return {
+            count: 0,
+            successIds: {},
+            failedIds: {},
+            errors: {},
+        };
+    }
+    // 大量レコード処理時の警告ログ出力（要件: 13.12）
+    logLargeBatchWarning('updateMany', ids.length, requestId, resource);
+    const dbClient = getDBClient();
+    const tableName = getTableName();
+    // BatchGetItemで既存レコードを取得
+    const keys = ids.map((id) => ({
+        PK: resource,
+        SK: generateMainRecordSK(id),
+    }));
+    const batchGetResult = await executeDynamoDBOperation(() => dbClient.send(new BatchGetCommand({
+        RequestItems: {
+            [tableName]: {
+                Keys: keys,
+                ConsistentRead: true,
+            },
+        },
+    })), 'BatchGetItem');
+    const existingItems = batchGetResult.Responses?.[tableName] || [];
+    // 存在するレコードのIDセットを作成
+    const existingIds = new Set(existingItems.map((item) => {
+        const data = item.data;
+        return data.id;
+    }));
+    // 存在しないIDを特定
+    const notFoundIds = ids.filter((id) => !existingIds.has(id));
+    // シャドー設定を取得（環境変数からキャッシュ付き）
+    const shadowConfig = getShadowConfig();
+    const shadowSchema = getResourceSchema(shadowConfig, resource);
+    const preparedRecords = [];
+    const preparationFailedIds = [];
+    const preparationErrors = [];
+    // 各レコードを準備
+    for (const item of existingItems) {
+        try {
+            const existingData = item.data;
+            const id = existingData.id;
+            const oldShadowKeys = existingData.__shadowKeys || [];
+            // JSON Merge Patchを適用
+            const mergedData = applyJsonMergePatch(removeShadowKeys(existingData), patchData);
+            // updatedAt を更新（タイムスタンプフィールド名は動的に取得）
+            const updatedData = addUpdateTimestamp({
+                ...mergedData,
+                id,
+            });
+            // 新しいシャドーレコードを生成
+            const newShadowRecords = generateShadowRecords(updatedData, shadowSchema);
+            const newShadowKeys = newShadowRecords.map((shadow) => shadow.SK);
+            // メインレコードのSKを生成
+            const mainSK = generateMainRecordSK(id);
+            preparedRecords.push({
+                id,
+                updatedData,
+                oldShadowKeys,
+                newShadowKeys,
+                mainSK,
+            });
+        }
+        catch (error) {
+            // 準備段階で失敗したレコードを記録
+            const existingData = item.data;
+            const failedId = existingData.id || 'unknown-id';
+            const errorMessage = error instanceof Error ? error.message : 'Unknown preparation error';
+            const errorCode = getPreparationErrorCode(error);
+            logger.error('Failed to prepare record for update', {
+                requestId,
+                recordId: failedId,
+                error: errorMessage,
+                errorCode,
+            });
+            // 準備失敗をエラーリストに追加
+            preparationFailedIds.push(failedId);
+            preparationErrors.push({
+                id: failedId,
+                code: errorCode,
+                message: errorMessage,
+            });
+        }
+    }
+    // アイテム数計算関数（1 + 削除シャドー数 + 追加シャドー数）
+    const getItemCount = (record) => {
+        const shadowDiff = calculateShadowDiff(record.oldShadowKeys, record.newShadowKeys);
+        return 1 + shadowDiff.toDelete.length + shadowDiff.toAdd.length;
+    };
+    // チャンク分割
+    const { chunks } = calculateChunks(preparedRecords, getItemCount);
+    // 準備段階の経過時間をチェック（要件: 13.12）
+    const preparationRiskInfo = calculateTimeoutRisk(startTime);
+    logPreparationTimeoutRisk(requestId, resource, preparedRecords.length, chunks.length, preparationRiskInfo);
+    // チャンク実行関数
+    const executeChunk = async (chunk) => {
+        const transactItems = [];
+        // チャンク内の各レコードをTransactItemsに変換
+        for (const record of chunk) {
+            // シャドー差分を計算
+            const shadowDiff = calculateShadowDiff(record.oldShadowKeys, record.newShadowKeys);
+            // メインレコードを更新
+            transactItems.push({
+                Put: {
+                    TableName: tableName,
+                    Item: {
+                        PK: resource,
+                        SK: record.mainSK,
+                        data: {
+                            ...record.updatedData,
+                            __shadowKeys: record.newShadowKeys,
+                        },
+                    },
+                },
+            });
+            // 旧シャドーを削除
+            for (const shadowSK of shadowDiff.toDelete) {
+                transactItems.push({
+                    Delete: {
+                        TableName: tableName,
+                        Key: {
+                            PK: resource,
+                            SK: shadowSK,
+                        },
+                    },
+                });
+            }
+            // 新シャドーを追加
+            for (const shadowSK of shadowDiff.toAdd) {
+                transactItems.push({
+                    Put: {
+                        TableName: tableName,
+                        Item: {
+                            PK: resource,
+                            SK: shadowSK,
+                            data: {},
+                        },
+                    },
+                });
+            }
+        }
+        // TransactWriteItemsを実行
+        await executeDynamoDBOperation(() => dbClient.send(new TransactWriteCommand({
+            TransactItems: transactItems,
+        })), 'TransactWriteItems');
+        // 成功したレコードを返す
+        return chunk;
+    };
+    // チャンクを順次実行
+    const { successRecords, failedIds: chunkFailedIds, errors: chunkErrors, } = await executeChunks(chunks, executeChunk, (record) => record.id);
+    // 統一レスポンス形式を構築
+    // successIds: インデックス付きオブジェクト（元の配列のインデックスとIDのマッピング）
+    const successIds = {};
+    const failedIdsMap = {};
+    const errorsMap = {};
+    // 成功したレコードのインデックスを特定
+    const successIdSet = new Set(successRecords.map((r) => r.id));
+    for (let i = 0; i < ids.length; i++) {
+        const id = ids[i];
+        if (successIdSet.has(id)) {
+            successIds[i] = id;
+        }
+    }
+    // 存在しないIDのインデックスを特定
+    for (let i = 0; i < ids.length; i++) {
+        const id = ids[i];
+        if (notFoundIds.includes(id)) {
+            failedIdsMap[i] = id;
+            errorsMap[i] = {
+                id,
+                code: 'ITEM_NOT_FOUND',
+                message: `Record not found: ${id}`,
+            };
+        }
+    }
+    // 準備失敗のインデックスを特定
+    for (let i = 0; i < ids.length; i++) {
+        const id = ids[i];
+        if (preparationFailedIds.includes(id)) {
+            failedIdsMap[i] = id;
+            const error = preparationErrors.find((e) => e.id === id);
+            if (error) {
+                errorsMap[i] = error;
+            }
+        }
+    }
+    // チャンク実行失敗のインデックスを特定
+    for (let i = 0; i < ids.length; i++) {
+        const id = ids[i];
+        if (chunkFailedIds.includes(id)) {
+            failedIdsMap[i] = id;
+            const error = chunkErrors.find((e) => e.id === id);
+            if (error) {
+                errorsMap[i] = {
+                    id: error.id,
+                    code: error.code,
+                    message: error.message,
+                };
+            }
+        }
+    }
+    const count = Object.keys(successIds).length;
+    const allFailedIds = Object.values(failedIdsMap);
+    // 総実行時間を計算（要件: 13.12）
+    const completionRiskInfo = calculateTimeoutRisk(startTime);
+    logBulkOperationComplete('updateMany', requestId, resource, ids.length, count, allFailedIds.length, completionRiskInfo, {
+        updated: count,
+        notFound: notFoundIds.length,
+        preparationFailed: preparationFailedIds.length,
+        chunkExecutionFailed: chunkFailedIds.length,
+    });
+    // 部分失敗の場合、詳細なエラーサマリーをログ出力
+    if (allFailedIds.length > 0) {
+        logPartialFailure('updateMany', requestId, resource, ids.length, count, allFailedIds.length, Object.values(errorsMap).map((e) => e.code), {
+            notFoundCount: notFoundIds.length,
+            preparationFailures: preparationFailedIds.length,
+            chunkExecutionFailures: chunkFailedIds.length,
+        });
+    }
+    // 統一レスポンス形式で返却
+    return {
+        count,
+        successIds,
+        failedIds: failedIdsMap,
+        errors: errorsMap,
+    };
+}
+/**
+ * 準備段階のエラーからエラーコードを抽出する
+ *
+ * @param error - エラーオブジェクト
+ * @returns エラーコード
+ */
+function getPreparationErrorCode(error) {
+    if (error && typeof error === 'object') {
+        // カスタムエラー
+        if ('code' in error && typeof error.code === 'string') {
+            return error.code;
+        }
+        // AWS SDK エラー
+        if ('name' in error && typeof error.name === 'string') {
+            return error.name;
+        }
+    }
+    return 'VALIDATION_ERROR';
+}
+//# sourceMappingURL=updateMany.js.map

package/dist/server/operations/updateMany.js.map

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

package/dist/server/operations/updateOne.d.ts

@@ -0,0 +1,20 @@
+import type { UpdateOneParams, UpdateOneResult } from '../types.js';
+/**
+ * updateOne 操作を実行する
+ *
+ * 処理フロー:
+ * 1. GetItemで既存レコードを取得
+ * 2. JSON Merge Patchを適用
+ * 3. updatedAtタイムスタンプを更新
+ * 4. 新しいシャドーSKを生成
+ * 5. 旧シャドーと新シャドーの差分を計算
+ * 6. TransactWriteItemsでメインレコード更新 + 旧シャドー削除 + 新シャドー追加
+ *
+ * @param resource - リソース名
+ * @param params - updateOneパラメータ
+ * @param requestId - リクエストID
+ * @returns 更新されたレコード
+ * @throws {ItemNotFoundError} レコードが存在しない場合
+ */
+export declare function handleUpdateOne(resource: string, params: UpdateOneParams, requestId: string): Promise<UpdateOneResult>;
+//# sourceMappingURL=updateOne.d.ts.map

package/dist/server/operations/updateOne.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateOne.d.ts","sourceRoot":"","sources":["../../../src/server/operations/updateOne.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAuDpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CA8H1B"}

package/dist/server/operations/updateOne.js

@@ -0,0 +1,159 @@
+/**
+ * updateOne 操作
+ * 単一レコードを更新する（JSON Merge Patch形式）
+ *
+ * 要件: 4.2, 4.4, 5.2, 5.3
+ */
+import { GetCommand, TransactWriteCommand } from '@aws-sdk/lib-dynamodb';
+import { ItemNotFoundError, createLogger, generateShadowRecords, getResourceSchema, getShadowConfig, } from '../../index.js';
+import { calculateShadowDiff, generateMainRecordSK, isDiffEmpty } from '../shadow/index.js';
+import { executeDynamoDBOperation, getDBClient, getTableName, removeShadowKeys, } from '../utils/dynamodb.js';
+import { addUpdateTimestamp } from '../utils/timestamps.js';
+const logger = createLogger({ service: 'records-lambda' });
+/**
+ * JSON Merge Patch (RFC 7396) を適用する
+ *
+ * ルール:
+ * - null値はフィールド削除を意味する
+ * - 配列は完全置換される
+ * - オブジェクトは再帰的にマージされる
+ *
+ * @param target - 対象オブジェクト
+ * @param patch - パッチオブジェクト
+ * @returns マージされたオブジェクト
+ */
+function applyJsonMergePatch(target, patch) {
+    const result = { ...target };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            // null値はフィールド削除
+            delete result[key];
+        }
+        else if (typeof value === 'object' &&
+            !Array.isArray(value) &&
+            value !== null &&
+            typeof result[key] === 'object' &&
+            !Array.isArray(result[key]) &&
+            result[key] !== null) {
+            // オブジェクトは再帰的にマージ
+            result[key] = applyJsonMergePatch(result[key], value);
+        }
+        else {
+            // その他（配列、プリミティブ）は完全置換
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * updateOne 操作を実行する
+ *
+ * 処理フロー:
+ * 1. GetItemで既存レコードを取得
+ * 2. JSON Merge Patchを適用
+ * 3. updatedAtタイムスタンプを更新
+ * 4. 新しいシャドーSKを生成
+ * 5. 旧シャドーと新シャドーの差分を計算
+ * 6. TransactWriteItemsでメインレコード更新 + 旧シャドー削除 + 新シャドー追加
+ *
+ * @param resource - リソース名
+ * @param params - updateOneパラメータ
+ * @param requestId - リクエストID
+ * @returns 更新されたレコード
+ * @throws {ItemNotFoundError} レコードが存在しない場合
+ */
+export async function handleUpdateOne(resource, params, requestId) {
+    const { id, data: patchData } = params;
+    logger.debug('Executing updateOne', {
+        requestId,
+        resource,
+        id,
+    });
+    const dbClient = getDBClient();
+    const tableName = getTableName();
+    // メインレコードのSKを生成
+    const mainSK = generateMainRecordSK(id);
+    // 既存レコードを取得
+    const getResult = await executeDynamoDBOperation(() => dbClient.send(new GetCommand({
+        TableName: tableName,
+        Key: {
+            PK: resource,
+            SK: mainSK,
+        },
+        ConsistentRead: true,
+    })), 'GetItem');
+    if (!getResult.Item) {
+        throw new ItemNotFoundError(`Record not found: ${id}`, { resource, id });
+    }
+    const existingData = getResult.Item.data;
+    const oldShadowKeys = existingData.__shadowKeys || [];
+    // JSON Merge Patchを適用
+    const mergedData = applyJsonMergePatch(removeShadowKeys(existingData), patchData);
+    // updatedAt を更新（タイムスタンプフィールド名は動的に取得）
+    const updatedData = addUpdateTimestamp({
+        ...mergedData,
+        id, // IDは変更不可
+    });
+    // シャドー設定を取得（環境変数からキャッシュ付き）
+    const shadowConfig = getShadowConfig();
+    const shadowSchema = getResourceSchema(shadowConfig, resource);
+    // 新しいシャドーレコードを生成
+    const newShadowRecords = generateShadowRecords(updatedData, shadowSchema);
+    const newShadowKeys = newShadowRecords.map((shadow) => shadow.SK);
+    // シャドー差分を計算
+    const shadowDiff = calculateShadowDiff(oldShadowKeys, newShadowKeys);
+    // TransactWriteItemsで一括更新
+    const transactItems = [];
+    // メインレコードを更新
+    transactItems.push({
+        Put: {
+            TableName: tableName,
+            Item: {
+                PK: resource,
+                SK: mainSK,
+                data: {
+                    ...updatedData,
+                    __shadowKeys: newShadowKeys,
+                },
+            },
+        },
+    });
+    // 旧シャドーを削除
+    for (const shadowSK of shadowDiff.toDelete) {
+        transactItems.push({
+            Delete: {
+                TableName: tableName,
+                Key: {
+                    PK: resource,
+                    SK: shadowSK,
+                },
+            },
+        });
+    }
+    // 新シャドーを追加
+    for (const shadowRecord of newShadowRecords) {
+        if (shadowDiff.toAdd.includes(shadowRecord.SK)) {
+            transactItems.push({
+                Put: {
+                    TableName: tableName,
+                    Item: shadowRecord,
+                },
+            });
+        }
+    }
+    // トランザクション実行
+    await executeDynamoDBOperation(() => dbClient.send(new TransactWriteCommand({
+        TransactItems: transactItems,
+    })), 'TransactWriteItems');
+    logger.info('updateOne succeeded', {
+        requestId,
+        resource,
+        id,
+        shadowDiffEmpty: isDiffEmpty(shadowDiff),
+        shadowsDeleted: shadowDiff.toDelete.length,
+        shadowsAdded: shadowDiff.toAdd.length,
+    });
+    // __shadowKeysを除外してレスポンスを返す
+    return removeShadowKeys(updatedData);
+}
+//# sourceMappingURL=updateOne.js.map

package/dist/server/operations/updateOne.js.map

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

package/dist/server/query/converter.d.ts

@@ -0,0 +1,85 @@
+/**
+ * クエリ変換ユーティリティ
+ *
+ * MongoDB風のFilterをDynamoDB形式に変換します。
+ *
+ * 要件: 8.5
+ */
+import type { Filter } from '../../types.js';
+/**
+ * DynamoDB比較演算子
+ */
+export type DynamoComparisonOperator = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin' | 'exists' | 'begins_with' | 'contains';
+/**
+ * DynamoDB条件
+ */
+export interface DynamoCondition {
+    /** フィールド名 */
+    field: string;
+    /** 比較演算子 */
+    operator: DynamoComparisonOperator;
+    /** 比較値 */
+    value: unknown;
+}
+/**
+ * DynamoDBクエリ
+ */
+export interface DynamoQuery {
+    /** パーティションキー（リソース名） */
+    pk: string;
+    /** 条件の配列 */
+    conditions: DynamoCondition[];
+    /** 論理演算子（デフォルト: AND） */
+    logicalOperator?: 'AND' | 'OR';
+}
+/**
+ * FilterをDynamoDB形式に変換する
+ *
+ * MongoDB風のFilter構文をDynamoDBのFilterExpression用の条件配列に変換します。
+ *
+ * @example
+ * ```typescript
+ * // 単純な等価条件
+ * const filter: Filter<Product> = { status: 'active' };
+ * const query = convertFilterToDynamo('products', filter);
+ * // => { pk: 'products', conditions: [{ field: 'status', operator: 'eq', value: 'active' }] }
+ *
+ * // 演算子を使用した条件
+ * const filter: Filter<Product> = {
+ *   price: { gte: 1000, lte: 5000 },
+ *   status: { in: ['active', 'pending'] }
+ * };
+ * const query = convertFilterToDynamo('products', filter);
+ * // => {
+ * //   pk: 'products',
+ * //   conditions: [
+ * //     { field: 'price', operator: 'gte', value: 1000 },
+ * //     { field: 'price', operator: 'lte', value: 5000 },
+ * //     { field: 'status', operator: 'in', value: ['active', 'pending'] }
+ * //   ]
+ * // }
+ *
+ * // OR条件
+ * const filter: Filter<Product> = {
+ *   or: [
+ *     { status: 'active' },
+ *     { priority: { gte: 5 } }
+ *   ]
+ * };
+ * const query = convertFilterToDynamo('products', filter);
+ * // => {
+ * //   pk: 'products',
+ * //   conditions: [
+ * //     { field: 'status', operator: 'eq', value: 'active' },
+ * //     { field: 'priority', operator: 'gte', value: 5 }
+ * //   ],
+ * //   logicalOperator: 'OR'
+ * // }
+ * ```
+ *
+ * @param collection - コレクション名（リソース名）
+ * @param filter - MongoDB風のフィルタ条件
+ * @returns DynamoDBクエリ
+ */
+export declare function convertFilterToDynamo<T = any>(collection: string, filter: Filter<T>): DynamoQuery;
+//# sourceMappingURL=converter.d.ts.map

package/dist/server/query/converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../../src/server/query/converter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,gBAAgB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,QAAQ,GACR,aAAa,GACb,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,QAAQ,EAAE,wBAAwB,CAAC;IACnC,UAAU;IACV,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,wBAAwB;IACxB,eAAe,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAkEjG"}