@exabugs/dynamodb-client 0.1.0

package/dist/server/operations/find.js

@@ -0,0 +1,382 @@
+/**
+ * find 操作
+ * リスト取得（フィルター・ソート・ページネーション対応）
+ *
+ * 要件: 4.3, 5.4, 5.5, 12.1-12.12
+ */
+import { BatchGetCommand, QueryCommand } from '@aws-sdk/lib-dynamodb';
+import { ConfigError, createLogger, getResourceSchema, getShadowConfig } from '../../index.js';
+import { executeDynamoDBOperation, extractCleanRecord, getDBClient, getTableName, } from '../utils/dynamodb.js';
+import { findOptimizableFilter, matchesAllFilters, parseFilterField, } from '../utils/filter.js';
+import { decodeNextToken, encodeNextToken } from '../utils/pagination.js';
+import { normalizePagination, normalizeSort, validateSortField } from '../utils/validation.js';
+const logger = createLogger({ service: 'records-lambda' });
+/**
+ * find 操作を実行する
+ *
+ * 処理フロー:
+ * 1. シャドー設定を読み込み、ソートフィールドを検証
+ * 2. シャドーレコードをQueryで取得（ソート済み）
+ * 3. 本体レコードをBatchGetItemで取得
+ * 4. フィルター条件を適用
+ * 5. ページネーション情報を生成してレスポンスを返す
+ *
+ * @param resource - リソース名
+ * @param params - findパラメータ
+ * @param requestId - リクエストID
+ * @returns リストデータ
+ */
+export async function handleFind(resource, params, requestId) {
+    logger.debug('Executing find', {
+        requestId,
+        resource,
+        params,
+    });
+    // シャドー設定を取得（環境変数からキャッシュ付き）
+    const shadowConfig = getShadowConfig();
+    logger.debug('Shadow config loaded', {
+        requestId,
+        resource,
+        hasResources: !!shadowConfig.resources,
+        resourceNames: Object.keys(shadowConfig.resources || {}),
+    });
+    // ソート条件を正規化（デフォルト値を適用）
+    logger.debug('Normalizing sort', {
+        requestId,
+        resource,
+        inputSort: params.sort,
+    });
+    const sort = normalizeSort(shadowConfig, resource, params.sort);
+    logger.debug('Sort normalized', {
+        requestId,
+        resource,
+        sort,
+    });
+    // ソートフィールドを検証
+    validateSortField(shadowConfig, resource, sort);
+    // ページネーション条件を正規化
+    const { perPage, nextToken } = normalizePagination(params.pagination);
+    // フィルター条件をパース（拡張フィールド構文対応）
+    // 要件: 12.1, 12.3, 12.4
+    const parsedFilters = [];
+    if (params.filter && Object.keys(params.filter).length > 0) {
+        for (const [fieldKey, value] of Object.entries(params.filter)) {
+            try {
+                const parsed = parseFilterField(fieldKey);
+                parsedFilters.push({ parsed, value });
+            }
+            catch (error) {
+                logger.error('Invalid filter field syntax', {
+                    requestId,
+                    fieldKey,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                throw new ConfigError(`Invalid filter field syntax: ${fieldKey}`, {
+                    field: fieldKey,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    const dbClient = getDBClient();
+    const tableName = getTableName();
+    // sort.field='id'の場合は本体レコードを直接クエリする（最適化）
+    // idフィールドは本体レコード（SK = id#{ULID}）として既に存在するため、
+    // 別途シャドーレコードを参照する必要がない
+    if (sort.field === 'id') {
+        // filter.idが指定されている場合は、特定のIDのレコードを取得
+        const idFilter = parsedFilters.find((f) => f.parsed.field === 'id');
+        if (idFilter && idFilter.parsed.operator === 'eq') {
+            // 特定のIDのレコードを取得（GetItemの代わりにQueryを使用）
+            const targetId = String(idFilter.value);
+            const queryResult = await executeDynamoDBOperation(() => dbClient.send(new QueryCommand({
+                TableName: tableName,
+                KeyConditionExpression: 'PK = :pk AND SK = :sk',
+                ExpressionAttributeValues: {
+                    ':pk': resource,
+                    ':sk': `id#${targetId}`,
+                },
+                ConsistentRead: true,
+            })), 'Query');
+            const mainRecords = queryResult.Items || [];
+            // クリーンなレコードに変換
+            const items = mainRecords.map((item) => extractCleanRecord(item));
+            logger.info('find succeeded (id sort optimization with filter)', {
+                requestId,
+                resource,
+                count: items.length,
+                hasNextPage: false,
+            });
+            return {
+                items,
+                pageInfo: {
+                    hasNextPage: false,
+                    hasPreviousPage: false,
+                },
+            };
+        }
+        // filter.idが指定されていない場合は、全レコードを取得
+        // ExclusiveStartKeyの設定（nextTokenがある場合）
+        let exclusiveStartKey;
+        if (nextToken) {
+            const decoded = decodeNextToken(nextToken);
+            exclusiveStartKey = {
+                PK: decoded.PK,
+                SK: decoded.SK,
+            };
+        }
+        // 本体レコードを直接Queryで取得
+        const queryResult = await executeDynamoDBOperation(() => dbClient.send(new QueryCommand({
+            TableName: tableName,
+            KeyConditionExpression: 'PK = :pk AND begins_with(SK, :skPrefix)',
+            ExpressionAttributeValues: {
+                ':pk': resource,
+                ':skPrefix': 'id#',
+            },
+            ScanIndexForward: sort.order === 'ASC', // ASC: true, DESC: false
+            Limit: perPage,
+            ExclusiveStartKey: exclusiveStartKey,
+            ConsistentRead: true,
+        })), 'Query');
+        const mainRecords = queryResult.Items || [];
+        // 本体レコードが0件の場合は空レスポンスを返す
+        if (mainRecords.length === 0) {
+            return {
+                items: [],
+                pageInfo: {
+                    hasNextPage: false,
+                    hasPreviousPage: false,
+                },
+            };
+        }
+        // クリーンなレコードに変換
+        let items = mainRecords.map((item) => extractCleanRecord(item));
+        // フィルター条件を適用（メモリ内フィルタリング）
+        // 要件: 12.6, 12.9
+        if (parsedFilters.length > 0) {
+            items = items.filter((record) => matchesAllFilters(record, parsedFilters));
+        }
+        // ページネーション情報を生成
+        // DynamoDBのクエリ結果がperPage件未満の場合、次のページは確実にない
+        // クエリ結果がperPage件ちょうどの場合、LastEvaluatedKeyがあれば次のページがある可能性がある
+        const hasNextPage = mainRecords.length < perPage ? false : queryResult.LastEvaluatedKey !== undefined;
+        const nextTokenValue = hasNextPage && queryResult.LastEvaluatedKey
+            ? encodeNextToken(queryResult.LastEvaluatedKey.PK, queryResult.LastEvaluatedKey.SK)
+            : undefined;
+        logger.info('find succeeded (id sort optimization)', {
+            requestId,
+            resource,
+            count: items.length,
+            hasNextPage,
+        });
+        return {
+            items,
+            pageInfo: {
+                hasNextPage,
+                hasPreviousPage: !!nextToken,
+            },
+            ...(nextTokenValue && { nextToken: nextTokenValue }),
+        };
+    }
+    // 通常のシャドーレコードクエリ（sort.field != 'id'の場合）
+    // シャドーフィールドの型情報を取得
+    const shadowSchema = getResourceSchema(shadowConfig, resource);
+    const sortFieldType = shadowSchema.sortableFields[sort.field]?.type;
+    if (!sortFieldType) {
+        throw new ConfigError(`Sort field type not found: ${sort.field}`, {
+            field: sort.field,
+            resource,
+        });
+    }
+    // Query最適化: ソートフィールドと一致するフィルター条件を検出
+    // 要件: 12.7
+    const optimizableFilter = findOptimizableFilter(sort.field, parsedFilters);
+    // シャドーSKのプレフィックスを生成
+    const skPrefix = `${sort.field}#`;
+    // ExclusiveStartKeyの設定（nextTokenがある場合）
+    let exclusiveStartKey;
+    if (nextToken) {
+        const decoded = decodeNextToken(nextToken);
+        exclusiveStartKey = {
+            PK: decoded.PK,
+            SK: decoded.SK,
+        };
+    }
+    // KeyConditionExpressionを構築（Query最適化を適用）
+    let keyConditionExpression;
+    const expressionAttributeValues = {
+        ':pk': resource,
+    };
+    if (optimizableFilter) {
+        // 最適化あり: ソートフィールドのフィルター条件をKeyConditionExpressionに含める
+        const { operator, type } = optimizableFilter.parsed;
+        const value = optimizableFilter.value;
+        // 値をシャドーSK形式にエンコード（簡易実装）
+        let encodedValue;
+        if (type === 'number') {
+            encodedValue = String(value).padStart(20, '0');
+        }
+        else if (type === 'date') {
+            encodedValue = new Date(String(value)).toISOString();
+        }
+        else if (type === 'boolean') {
+            encodedValue = String(value);
+        }
+        else {
+            // string型: エスケープ処理（# → ##、スペース → #）
+            encodedValue = String(value).replace(/#/g, '##').replace(/ /g, '#');
+        }
+        // SK形式: {field}#{encodedValue}#id#{recordId}
+        const skValue = `${sort.field}#${encodedValue}`;
+        switch (operator) {
+            case 'eq':
+                // 完全一致: {field}#{value}#id# で始まるレコードを取得
+                keyConditionExpression = 'PK = :pk AND begins_with(SK, :skValue)';
+                expressionAttributeValues[':skValue'] = `${skValue}#id#`;
+                break;
+            case 'gt':
+                // より大きい: {field}#{value}#id#~ より大きいSKを取得
+                // ~ は # の次の文字なので、{field}#{value}#id#{任意のID} より大きくなる
+                keyConditionExpression = 'PK = :pk AND SK > :skValue';
+                expressionAttributeValues[':skValue'] = `${skValue}#id#~`;
+                break;
+            case 'gte':
+                // 以上: {field}#{value}#id# 以上のSKを取得
+                keyConditionExpression = 'PK = :pk AND SK >= :skValue';
+                expressionAttributeValues[':skValue'] = `${skValue}#id#`;
+                break;
+            case 'lt':
+                // より小さい: {field}#{value}#id# より小さいSKを取得
+                keyConditionExpression = 'PK = :pk AND SK < :skValue';
+                expressionAttributeValues[':skValue'] = `${skValue}#id#`;
+                break;
+            case 'lte':
+                // 以下: {field}#{value}#id#~ 以下のSKを取得
+                keyConditionExpression = 'PK = :pk AND SK <= :skValue';
+                expressionAttributeValues[':skValue'] = `${skValue}#id#~`;
+                break;
+            case 'starts':
+                // 前方一致: {field}#{value} で始まるSKを取得
+                keyConditionExpression = 'PK = :pk AND begins_with(SK, :skValue)';
+                expressionAttributeValues[':skValue'] = `${skValue}`;
+                break;
+            default:
+                // フォールバック: 前方一致のみ
+                keyConditionExpression = 'PK = :pk AND begins_with(SK, :skPrefix)';
+                expressionAttributeValues[':skPrefix'] = skPrefix;
+        }
+        logger.debug('Query optimization applied', {
+            requestId,
+            sortField: sort.field,
+            operator,
+            type,
+            value,
+            skValue,
+        });
+    }
+    else {
+        // 最適化なし: 前方一致のみ
+        keyConditionExpression = 'PK = :pk AND begins_with(SK, :skPrefix)';
+        expressionAttributeValues[':skPrefix'] = skPrefix;
+    }
+    // シャドーレコードをQueryで取得
+    const queryResult = await executeDynamoDBOperation(() => dbClient.send(new QueryCommand({
+        TableName: tableName,
+        KeyConditionExpression: keyConditionExpression,
+        ExpressionAttributeValues: expressionAttributeValues,
+        ScanIndexForward: sort.order === 'ASC', // ASC: true, DESC: false
+        Limit: perPage,
+        ExclusiveStartKey: exclusiveStartKey,
+        ConsistentRead: true,
+    })), 'Query');
+    const shadowItems = queryResult.Items || [];
+    // シャドーレコードが0件の場合は空レスポンスを返す
+    if (shadowItems.length === 0) {
+        return {
+            items: [],
+            pageInfo: {
+                hasNextPage: false,
+                hasPreviousPage: false,
+            },
+        };
+    }
+    // シャドーSKからレコードIDを抽出
+    const recordIds = shadowItems.map((item) => {
+        const sk = item.SK;
+        // SK形式: {field}#{value}#id#{recordId}
+        const parts = sk.split('#id#');
+        return parts[parts.length - 1];
+    });
+    // 重複を除去（同じレコードに対して複数のシャドーレコードが存在する場合）
+    const uniqueRecordIds = Array.from(new Set(recordIds));
+    // 本体レコードをBatchGetItemで取得
+    const batchGetResult = await executeDynamoDBOperation(() => dbClient.send(new BatchGetCommand({
+        RequestItems: {
+            [tableName]: {
+                Keys: uniqueRecordIds.map((id) => ({
+                    PK: resource,
+                    SK: `id#${id}`,
+                })),
+                ConsistentRead: true,
+            },
+        },
+    })), 'BatchGetItem');
+    const mainRecords = batchGetResult.Responses?.[tableName] || [];
+    // IDでマッピングを作成（順序を保持するため）
+    const recordMap = new Map(mainRecords.map((item) => {
+        const data = item.data;
+        return [data.id, extractCleanRecord(item)];
+    }));
+    // シャドーの順序でレコードを並べる（重複を除去）
+    // 元のrecordIdsの順序を保持しつつ、重複を除去する
+    const seenIds = new Set();
+    let items = recordIds
+        .filter((id) => {
+        if (seenIds.has(id)) {
+            return false; // 既に処理済みのIDはスキップ
+        }
+        seenIds.add(id);
+        return true;
+    })
+        .map((id) => recordMap.get(id))
+        .filter((record) => record !== undefined);
+    // フィルター条件を適用（メモリ内フィルタリング）
+    // 要件: 12.6, 12.9, 12.11
+    // Query 最適化はあくまで候補を絞り込むためのもので、完全なフィルタリングではない
+    // （例: starts オペレーターは SK の前方一致だが、値の途中にマッチする可能性がある）
+    // そのため、すべてのフィルター条件をメモリ内で再適用する
+    if (parsedFilters.length > 0) {
+        const itemsBeforeFilter = items.length;
+        items = items.filter((record) => matchesAllFilters(record, parsedFilters));
+        logger.debug('Memory filtering applied', {
+            requestId,
+            filtersCount: parsedFilters.length,
+            itemsBeforeFilter,
+            itemsAfterFilter: items.length,
+            filtered: itemsBeforeFilter - items.length,
+        });
+    }
+    // ページネーション情報を生成
+    // DynamoDBのクエリ結果がperPage件未満の場合、次のページは確実にない
+    // クエリ結果がperPage件ちょうどの場合、LastEvaluatedKeyがあれば次のページがある可能性がある
+    // （フィルタリング後のitemsが少なくても、次のページにフィルタリング後のデータがある可能性がある）
+    const hasNextPage = shadowItems.length < perPage ? false : queryResult.LastEvaluatedKey !== undefined;
+    const nextTokenValue = hasNextPage && queryResult.LastEvaluatedKey
+        ? encodeNextToken(queryResult.LastEvaluatedKey.PK, queryResult.LastEvaluatedKey.SK)
+        : undefined;
+    logger.info('find succeeded', {
+        requestId,
+        resource,
+        count: items.length,
+        hasNextPage,
+    });
+    return {
+        items,
+        pageInfo: {
+            hasNextPage,
+            hasPreviousPage: !!nextToken,
+        },
+        ...(nextTokenValue && { nextToken: nextTokenValue }),
+    };
+}
+//# sourceMappingURL=find.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { FindManyParams, FindManyResult } from '../types.js';
+/**
+ * findMany 操作を実行する
+ *
+ * BatchGetItemで複数のメインレコードを取得し、__shadowKeysを除外してレスポンスを返す。
+ *
+ * @param resource - リソース名
+ * @param params - findManyパラメータ
+ * @param requestId - リクエストID
+ * @returns レコードデータの配列
+ */
+export declare function handleFindMany(resource: string, params: FindManyParams, requestId: string): Promise<FindManyResult>;
+//# sourceMappingURL=findMany.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findMany.d.ts","sourceRoot":"","sources":["../../../src/server/operations/findMany.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAUlE;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAqDzB"}

package/dist/server/operations/findMany.js

@@ -0,0 +1,61 @@
+/**
+ * findMany 操作
+ * 複数レコードをIDリストで取得する
+ *
+ * 要件: 4.3, 5.4, 5.5
+ */
+import { BatchGetCommand } from '@aws-sdk/lib-dynamodb';
+import { createLogger } from '../../index.js';
+import { generateMainRecordSK } from '../shadow/index.js';
+import { executeDynamoDBOperation, extractCleanRecord, getDBClient, getTableName, } from '../utils/dynamodb.js';
+const logger = createLogger({ service: 'records-lambda' });
+/**
+ * findMany 操作を実行する
+ *
+ * BatchGetItemで複数のメインレコードを取得し、__shadowKeysを除外してレスポンスを返す。
+ *
+ * @param resource - リソース名
+ * @param params - findManyパラメータ
+ * @param requestId - リクエストID
+ * @returns レコードデータの配列
+ */
+export async function handleFindMany(resource, params, requestId) {
+    const { ids } = params;
+    logger.debug('Executing findMany', {
+        requestId,
+        resource,
+        count: ids.length,
+    });
+    // IDが空の場合は空配列を返す
+    if (ids.length === 0) {
+        return [];
+    }
+    const dbClient = getDBClient();
+    const tableName = getTableName();
+    // BatchGetItemのキーを生成
+    const keys = ids.map((id) => ({
+        PK: resource,
+        SK: generateMainRecordSK(id),
+    }));
+    // BatchGetItemでレコードを取得（ConsistentRead=true）
+    const result = await executeDynamoDBOperation(() => dbClient.send(new BatchGetCommand({
+        RequestItems: {
+            [tableName]: {
+                Keys: keys,
+                ConsistentRead: true,
+            },
+        },
+    })), 'BatchGetItem');
+    // レスポンスからレコードを抽出
+    const items = result.Responses?.[tableName] || [];
+    // data属性から__shadowKeysを除外
+    const records = items.map((item) => extractCleanRecord(item));
+    logger.info('findMany succeeded', {
+        requestId,
+        resource,
+        requested: ids.length,
+        found: records.length,
+    });
+    return records;
+}
+//# sourceMappingURL=findMany.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findMany.js","sourceRoot":"","sources":["../../../src/server/operations/findMany.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,MAAsB,EACtB,SAAiB;IAEjB,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAEvB,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE;QACjC,SAAS;QACT,QAAQ;QACR,KAAK,EAAE,GAAG,CAAC,MAAM;KAClB,CAAC,CAAC;IAEH,iBAAiB;IACjB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,qBAAqB;IACrB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5B,EAAE,EAAE,QAAQ;QACZ,EAAE,EAAE,oBAAoB,CAAC,EAAE,CAAC;KAC7B,CAAC,CAAC,CAAC;IAEJ,4CAA4C;IAC5C,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAC3C,GAAG,EAAE,CACH,QAAQ,CAAC,IAAI,CACX,IAAI,eAAe,CAAC;QAClB,YAAY,EAAE;YACZ,CAAC,SAAS,CAAC,EAAE;gBACX,IAAI,EAAE,IAAI;gBACV,cAAc,EAAE,IAAI;aACrB;SACF;KACF,CAAC,CACH,EACH,cAAc,CACf,CAAC;IAEF,iBAAiB;IACjB,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAElD,0BAA0B;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9D,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;QAChC,SAAS;QACT,QAAQ;QACR,SAAS,EAAE,GAAG,CAAC,MAAM;QACrB,KAAK,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { FindManyReferenceParams, FindManyReferenceResult } from '../types.js';
+/**
+ * findManyReference 操作を実行する
+ *
+ * 処理フロー:
+ * 1. シャドー設定を読み込み、ソートフィールドを検証
+ * 2. シャドーレコードをQueryで取得（ソート済み）
+ * 3. 本体レコードをBatchGetItemで取得
+ * 4. target/idフィルターとユーザー指定フィルターを適用
+ * 5. ページネーション情報を生成してレスポンスを返す
+ *
+ * @param resource - リソース名
+ * @param params - findManyReferenceパラメータ
+ * @param requestId - リクエストID
+ * @returns リストデータ
+ */
+export declare function handleFindManyReference(resource: string, params: FindManyReferenceParams, requestId: string): Promise<FindManyReferenceResult>;
+//# sourceMappingURL=findManyReference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findManyReference.d.ts","sourceRoot":"","sources":["../../../src/server/operations/findManyReference.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAYpF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,uBAAuB,EAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAkKlC"}

package/dist/server/operations/findManyReference.js

@@ -0,0 +1,150 @@
+/**
+ * findManyReference 操作
+ * 参照レコード取得（外部キー指定）
+ *
+ * 要件: 4.3, 5.4, 5.5
+ */
+import { BatchGetCommand, QueryCommand } from '@aws-sdk/lib-dynamodb';
+import { ConfigError, createLogger, getResourceSchema, getShadowConfig } from '../../index.js';
+import { executeDynamoDBOperation, extractCleanRecord, getDBClient, getTableName, } from '../utils/dynamodb.js';
+import { decodeNextToken, encodeNextToken } from '../utils/pagination.js';
+import { normalizePagination, normalizeSort, validateSortField } from '../utils/validation.js';
+const logger = createLogger({ service: 'records-lambda' });
+/**
+ * findManyReference 操作を実行する
+ *
+ * 処理フロー:
+ * 1. シャドー設定を読み込み、ソートフィールドを検証
+ * 2. シャドーレコードをQueryで取得（ソート済み）
+ * 3. 本体レコードをBatchGetItemで取得
+ * 4. target/idフィルターとユーザー指定フィルターを適用
+ * 5. ページネーション情報を生成してレスポンスを返す
+ *
+ * @param resource - リソース名
+ * @param params - findManyReferenceパラメータ
+ * @param requestId - リクエストID
+ * @returns リストデータ
+ */
+export async function handleFindManyReference(resource, params, requestId) {
+    const { target, id, filter, sort: sortParam, pagination } = params;
+    logger.debug('Executing findManyReference', {
+        requestId,
+        resource,
+        target,
+        id,
+    });
+    // シャドー設定を取得（環境変数からキャッシュ付き）
+    const shadowConfig = getShadowConfig();
+    // ソート条件を正規化（デフォルト値を適用）
+    const sort = normalizeSort(shadowConfig, resource, sortParam);
+    // ソートフィールドを検証
+    validateSortField(shadowConfig, resource, sort);
+    // ページネーション条件を正規化
+    const { perPage, nextToken } = normalizePagination(pagination);
+    const dbClient = getDBClient();
+    const tableName = getTableName();
+    // シャドーフィールドの型情報を取得
+    const shadowSchema = getResourceSchema(shadowConfig, resource);
+    const sortFieldType = shadowSchema.sortableFields[sort.field]?.type;
+    if (!sortFieldType) {
+        throw new ConfigError(`Sort field type not found: ${sort.field}`, {
+            field: sort.field,
+            resource,
+        });
+    }
+    // シャドーSKのプレフィックスを生成
+    const skPrefix = `${sort.field}#`;
+    // ExclusiveStartKeyの設定（nextTokenがある場合）
+    let exclusiveStartKey;
+    if (nextToken) {
+        const decoded = decodeNextToken(nextToken);
+        exclusiveStartKey = {
+            PK: decoded.PK,
+            SK: decoded.SK,
+        };
+    }
+    // シャドーレコードをQueryで取得
+    const queryResult = await executeDynamoDBOperation(() => dbClient.send(new QueryCommand({
+        TableName: tableName,
+        KeyConditionExpression: 'PK = :pk AND begins_with(SK, :skPrefix)',
+        ExpressionAttributeValues: {
+            ':pk': resource,
+            ':skPrefix': skPrefix,
+        },
+        ScanIndexForward: sort.order === 'ASC',
+        Limit: perPage,
+        ExclusiveStartKey: exclusiveStartKey,
+        ConsistentRead: true,
+    })), 'Query');
+    const shadowItems = queryResult.Items || [];
+    // シャドーレコードが0件の場合は空レスポンスを返す
+    if (shadowItems.length === 0) {
+        return {
+            items: [],
+            pageInfo: {
+                hasNextPage: false,
+                hasPreviousPage: false,
+            },
+        };
+    }
+    // シャドーSKからレコードIDを抽出
+    const recordIds = shadowItems.map((item) => {
+        const sk = item.SK;
+        const parts = sk.split('#id#');
+        return parts[parts.length - 1];
+    });
+    // 本体レコードをBatchGetItemで取得
+    const batchGetResult = await executeDynamoDBOperation(() => dbClient.send(new BatchGetCommand({
+        RequestItems: {
+            [tableName]: {
+                Keys: recordIds.map((recordId) => ({
+                    PK: resource,
+                    SK: `id#${recordId}`,
+                })),
+                ConsistentRead: true,
+            },
+        },
+    })), 'BatchGetItem');
+    const mainRecords = batchGetResult.Responses?.[tableName] || [];
+    // IDでマッピングを作成
+    const recordMap = new Map(mainRecords.map((item) => {
+        const data = item.data;
+        return [data.id, extractCleanRecord(item)];
+    }));
+    // シャドーの順序でレコードを並べる
+    let items = recordIds
+        .map((recordId) => recordMap.get(recordId))
+        .filter((record) => record !== undefined);
+    // target/idフィルターを適用
+    items = items.filter((record) => record[target] === id);
+    // 追加のフィルター条件を適用
+    if (filter && Object.keys(filter).length > 0) {
+        items = items.filter((record) => {
+            return Object.entries(filter).every(([key, value]) => {
+                return record[key] === value;
+            });
+        });
+    }
+    // ページネーション情報を生成
+    const hasNextPage = queryResult.LastEvaluatedKey !== undefined;
+    const nextTokenValue = hasNextPage && queryResult.LastEvaluatedKey
+        ? encodeNextToken(queryResult.LastEvaluatedKey.PK, queryResult.LastEvaluatedKey.SK)
+        : undefined;
+    logger.info('findManyReference succeeded', {
+        requestId,
+        resource,
+        target,
+        id,
+        count: items.length,
+        hasNextPage,
+    });
+    return {
+        items,
+        pageInfo: {
+            hasNextPage,
+            hasPreviousPage: !!nextToken,
+        },
+        ...(nextTokenValue && { nextToken: nextTokenValue }),
+    };
+}
+//# sourceMappingURL=findManyReference.js.map