@exabugs/dynamodb-client 0.1.0

package/dist/server/utils/auth.d.ts

@@ -0,0 +1,43 @@
+import type { CognitoJwtPayload } from 'aws-jwt-verify/jwt-model';
+/**
+ * JWT ペイロード（Cognito ID Token）
+ * aws-jwt-verify の CognitoJwtPayload を使用
+ */
+export type JwtPayload = CognitoJwtPayload;
+/**
+ * Cognito JWT トークンを検証する（署名検証あり）
+ *
+ * aws-jwt-verify を使用して以下を検証:
+ * - 署名検証（JWKS を使用した RSA 署名検証）
+ * - 有効期限（exp）
+ * - 発行時刻（iat）
+ * - 発行者（iss）
+ * - オーディエンス（aud、clientId が指定されている場合）
+ * - token_use（'id' トークンのみ許可）
+ *
+ * @param token - JWT トークン（Bearer プレフィックスなし）
+ * @param userPoolId - Cognito User Pool ID
+ * @param clientId - Cognito App Client ID（オプション）
+ * @returns 検証済みの JWT ペイロード
+ * @throws トークンが無効な場合
+ */
+export declare function verifyJwt(token: string, userPoolId: string, clientId?: string): Promise<JwtPayload>;
+/**
+ * HTTP Authorization ヘッダーから JWT トークンを抽出する
+ *
+ * @param authHeader - Authorization ヘッダーの値
+ * @returns JWT トークン（Bearer プレフィックスなし）
+ * @throws ヘッダーの形式が不正な場合
+ */
+export declare function extractTokenFromHeader(authHeader: string | undefined): string;
+/**
+ * HTTP リクエストから JWT トークンを検証する（ヘルパー関数）
+ *
+ * @param authHeader - Authorization ヘッダーの値
+ * @param userPoolId - Cognito User Pool ID
+ * @param clientId - Cognito App Client ID（オプション）
+ * @returns 検証済みの JWT ペイロード
+ * @throws トークンが無効な場合
+ */
+export declare function verifyAuthHeader(authHeader: string | undefined, userPoolId: string, clientId?: string): Promise<JwtPayload>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/server/utils/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/server/utils/auth.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAMlE;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,CAAC;AA+B3C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAyCrB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAY7E;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAGrB"}

package/dist/server/utils/auth.js

@@ -0,0 +1,123 @@
+/**
+ * Cognito JWT 検証ユーティリティ
+ * aws-jwt-verify を使用した署名検証を実装
+ *
+ * 要件: 9.1, 9.3
+ */
+import { CognitoJwtVerifier } from 'aws-jwt-verify';
+import { AuthError, createLogger } from '../../index.js';
+const logger = createLogger({ service: 'records-lambda' });
+/**
+ * JWT Verifier インスタンス（Lambda コンテキスト間で再利用）
+ *
+ * aws-jwt-verify は内部で JWKS をキャッシュするため、
+ * グローバル変数として保持することでパフォーマンスを向上させる
+ */
+let verifierInstance = null;
+/**
+ * JWT Verifier インスタンスを取得する（シングルトンパターン）
+ *
+ * @param userPoolId - Cognito User Pool ID
+ * @param clientId - Cognito App Client ID（オプション、指定時は aud を検証）
+ * @returns JWT Verifier インスタンス
+ */
+function getVerifier(userPoolId, clientId) {
+    if (!verifierInstance) {
+        logger.debug('Creating JWT verifier instance', { userPoolId, clientId });
+        verifierInstance = CognitoJwtVerifier.create({
+            userPoolId,
+            tokenUse: 'id', // ID トークンを検証
+            clientId: clientId || null, // undefined を null に変換（aws-jwt-verify の型要件）
+        });
+    }
+    return verifierInstance;
+}
+/**
+ * Cognito JWT トークンを検証する（署名検証あり）
+ *
+ * aws-jwt-verify を使用して以下を検証:
+ * - 署名検証（JWKS を使用した RSA 署名検証）
+ * - 有効期限（exp）
+ * - 発行時刻（iat）
+ * - 発行者（iss）
+ * - オーディエンス（aud、clientId が指定されている場合）
+ * - token_use（'id' トークンのみ許可）
+ *
+ * @param token - JWT トークン（Bearer プレフィックスなし）
+ * @param userPoolId - Cognito User Pool ID
+ * @param clientId - Cognito App Client ID（オプション）
+ * @returns 検証済みの JWT ペイロード
+ * @throws トークンが無効な場合
+ */
+export async function verifyJwt(token, userPoolId, clientId) {
+    logger.debug('Verifying JWT token with signature validation');
+    try {
+        const verifier = getVerifier(userPoolId, clientId);
+        // aws-jwt-verify による完全な検証（署名検証を含む）
+        const payload = await verifier.verify(token);
+        logger.debug('JWT token verified successfully', {
+            sub: payload.sub,
+            email: payload.email,
+            tokenUse: payload.token_use,
+        });
+        return payload;
+    }
+    catch (error) {
+        logger.error('JWT verification failed', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        // エラーメッセージを整形
+        let message = 'JWT verification failed';
+        if (error instanceof Error) {
+            if (error.message.includes('expired')) {
+                message = 'Token has expired';
+            }
+            else if (error.message.includes('invalid signature')) {
+                message = 'Invalid token signature';
+            }
+            else if (error.message.includes('invalid issuer')) {
+                message = 'Invalid token issuer';
+            }
+            else if (error.message.includes('invalid audience')) {
+                message = 'Invalid token audience';
+            }
+            else {
+                message = error.message;
+            }
+        }
+        throw new AuthError(message, {
+            originalError: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+/**
+ * HTTP Authorization ヘッダーから JWT トークンを抽出する
+ *
+ * @param authHeader - Authorization ヘッダーの値
+ * @returns JWT トークン（Bearer プレフィックスなし）
+ * @throws ヘッダーの形式が不正な場合
+ */
+export function extractTokenFromHeader(authHeader) {
+    if (!authHeader) {
+        throw new AuthError('Missing Authorization header');
+    }
+    const parts = authHeader.split(' ');
+    if (parts.length !== 2 || parts[0] !== 'Bearer') {
+        throw new AuthError('Invalid Authorization header format: expected "Bearer <token>"');
+    }
+    return parts[1];
+}
+/**
+ * HTTP リクエストから JWT トークンを検証する（ヘルパー関数）
+ *
+ * @param authHeader - Authorization ヘッダーの値
+ * @param userPoolId - Cognito User Pool ID
+ * @param clientId - Cognito App Client ID（オプション）
+ * @returns 検証済みの JWT ペイロード
+ * @throws トークンが無効な場合
+ */
+export async function verifyAuthHeader(authHeader, userPoolId, clientId) {
+    const token = extractTokenFromHeader(authHeader);
+    return await verifyJwt(token, userPoolId, clientId);
+}
+//# sourceMappingURL=auth.js.map

package/dist/server/utils/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/server/utils/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAQ3D;;;;;GAKG;AACH,IAAI,gBAAgB,GAAwD,IAAI,CAAC;AAEjF;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,UAAkB,EAAE,QAAiB;IACxD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEzE,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,CAAC;YAC3C,UAAU;YACV,QAAQ,EAAE,IAAI,EAAE,aAAa;YAC7B,QAAQ,EAAE,QAAQ,IAAI,IAAI,EAAE,4CAA4C;SACzE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAa,EACb,UAAkB,EAClB,QAAiB;IAEjB,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEnD,mCAAmC;QACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE7C,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE;YAC9C,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE;YACtC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QAEH,cAAc;QACd,IAAI,OAAO,GAAG,yBAAyB,CAAC;QACxC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,OAAO,GAAG,mBAAmB,CAAC;YAChC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBACvD,OAAO,GAAG,yBAAyB,CAAC;YACtC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACpD,OAAO,GAAG,sBAAsB,CAAC;YACnC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACtD,OAAO,GAAG,wBAAwB,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,IAAI,SAAS,CAAC,OAAO,EAAE;YAC3B,aAAa,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAA8B;IACnE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,SAAS,CAAC,gEAAgE,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAA8B,EAC9B,UAAkB,EAClB,QAAiB;IAEjB,MAAM,KAAK,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACjD,OAAO,MAAM,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC"}

package/dist/server/utils/bulkOperations.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Lambda実行時間制限（ミリ秒）
+ * AWS Lambdaの最大実行時間は15分（900秒）
+ */
+export declare const LAMBDA_TIMEOUT_MS: number;
+/**
+ * 警告を出すレコード数の閾値
+ * この数を超えるとタイムアウトリスクの警告を出力
+ */
+export declare const LARGE_BATCH_WARNING_THRESHOLD = 1000;
+/**
+ * タイムアウトリスク判定の閾値（残り時間の割合）
+ * 残り時間がこの割合未満になると高リスクと判定
+ */
+export declare const TIMEOUT_RISK_THRESHOLD = 0.2;
+/**
+ * バルク操作のタイムアウトリスク情報
+ */
+export interface TimeoutRiskInfo {
+    /** 経過時間（ミリ秒） */
+    elapsedMs: number;
+    /** 残り時間（ミリ秒） */
+    remainingMs: number;
+    /** タイムアウトリスク（high/low） */
+    risk: 'high' | 'low';
+    /** タイムアウト利用率（0-100%） */
+    utilizationPercent: number;
+}
+/**
+ * 大量レコード処理時の警告ログを出力する
+ *
+ * @param operation - 操作名（createMany、updateMany、deleteManyなど）
+ * @param recordCount - レコード数
+ * @param requestId - リクエストID
+ * @param resource - リソース名
+ */
+export declare function logLargeBatchWarning(operation: string, recordCount: number, requestId: string, resource: string): void;
+/**
+ * タイムアウトリスク情報を計算する
+ *
+ * @param startTime - 処理開始時刻（Date.now()の値）
+ * @returns タイムアウトリスク情報
+ */
+export declare function calculateTimeoutRisk(startTime: number): TimeoutRiskInfo;
+/**
+ * 準備段階のタイムアウトリスクをログ出力する
+ *
+ * @param requestId - リクエストID
+ * @param resource - リソース名
+ * @param totalRecords - 総レコード数
+ * @param chunkCount - チャンク数
+ * @param riskInfo - タイムアウトリスク情報
+ */
+export declare function logPreparationTimeoutRisk(requestId: string, resource: string, totalRecords: number, chunkCount: number, riskInfo: TimeoutRiskInfo): void;
+/**
+ * バルク操作完了時のログを出力する
+ *
+ * @param operation - 操作名（createMany、updateMany、deleteManyなど）
+ * @param requestId - リクエストID
+ * @param resource - リソース名
+ * @param requested - リクエストされたレコード数
+ * @param succeeded - 成功したレコード数
+ * @param failed - 失敗したレコード数
+ * @param riskInfo - タイムアウトリスク情報
+ * @param additionalInfo - 追加情報（オプション）
+ */
+export declare function logBulkOperationComplete(operation: string, requestId: string, resource: string, requested: number, succeeded: number, failed: number, riskInfo: TimeoutRiskInfo, additionalInfo?: Record<string, unknown>): void;
+/**
+ * 部分失敗時の詳細ログを出力する
+ *
+ * @param operation - 操作名（createMany、updateMany、deleteManyなど）
+ * @param requestId - リクエストID
+ * @param resource - リソース名
+ * @param requested - リクエストされたレコード数
+ * @param succeeded - 成功したレコード数
+ * @param failed - 失敗したレコード数
+ * @param errorCodes - エラーコードの配列
+ * @param additionalInfo - 追加情報（オプション）
+ */
+export declare function logPartialFailure(operation: string, requestId: string, resource: string, requested: number, succeeded: number, failed: number, errorCodes: string[], additionalInfo?: Record<string, unknown>): void;
+//# sourceMappingURL=bulkOperations.d.ts.map

package/dist/server/utils/bulkOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkOperations.d.ts","sourceRoot":"","sources":["../../../src/server/utils/bulkOperations.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,wBAAwB;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,IAAI,CAYN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAYvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,eAAe,GACxB,IAAI,CAsBN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,IAAI,CAeN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,IAAI,CAaN"}

package/dist/server/utils/bulkOperations.js

@@ -0,0 +1,147 @@
+/**
+ * バルク操作共通ユーティリティ
+ *
+ * createMany、updateMany、deleteManyなどのバルク操作で共通して使用される
+ * 定数、型、ヘルパー関数を提供する。
+ *
+ * 要件: 13.12
+ */
+import { createLogger } from '../../index.js';
+const logger = createLogger({ service: 'records-lambda' });
+/**
+ * Lambda実行時間制限（ミリ秒）
+ * AWS Lambdaの最大実行時間は15分（900秒）
+ */
+export const LAMBDA_TIMEOUT_MS = 15 * 60 * 1000; // 15分
+/**
+ * 警告を出すレコード数の閾値
+ * この数を超えるとタイムアウトリスクの警告を出力
+ */
+export const LARGE_BATCH_WARNING_THRESHOLD = 1000;
+/**
+ * タイムアウトリスク判定の閾値（残り時間の割合）
+ * 残り時間がこの割合未満になると高リスクと判定
+ */
+export const TIMEOUT_RISK_THRESHOLD = 0.2; // 20%
+/**
+ * 大量レコード処理時の警告ログを出力する
+ *
+ * @param operation - 操作名（createMany、updateMany、deleteManyなど）
+ * @param recordCount - レコード数
+ * @param requestId - リクエストID
+ * @param resource - リソース名
+ */
+export function logLargeBatchWarning(operation, recordCount, requestId, resource) {
+    if (recordCount > LARGE_BATCH_WARNING_THRESHOLD) {
+        logger.warn(`Large batch ${operation} operation detected`, {
+            requestId,
+            resource,
+            recordCount,
+            warningThreshold: LARGE_BATCH_WARNING_THRESHOLD,
+            estimatedTimeoutRisk: 'high',
+            recommendation: 'Consider splitting the batch into smaller requests to avoid Lambda timeout (15 min limit)',
+        });
+    }
+}
+/**
+ * タイムアウトリスク情報を計算する
+ *
+ * @param startTime - 処理開始時刻（Date.now()の値）
+ * @returns タイムアウトリスク情報
+ */
+export function calculateTimeoutRisk(startTime) {
+    const elapsedMs = Date.now() - startTime;
+    const remainingMs = LAMBDA_TIMEOUT_MS - elapsedMs;
+    const utilizationPercent = Math.round((elapsedMs / LAMBDA_TIMEOUT_MS) * 100);
+    const risk = remainingMs < LAMBDA_TIMEOUT_MS * TIMEOUT_RISK_THRESHOLD ? 'high' : 'low';
+    return {
+        elapsedMs,
+        remainingMs,
+        risk,
+        utilizationPercent,
+    };
+}
+/**
+ * 準備段階のタイムアウトリスクをログ出力する
+ *
+ * @param requestId - リクエストID
+ * @param resource - リソース名
+ * @param totalRecords - 総レコード数
+ * @param chunkCount - チャンク数
+ * @param riskInfo - タイムアウトリスク情報
+ */
+export function logPreparationTimeoutRisk(requestId, resource, totalRecords, chunkCount, riskInfo) {
+    logger.info('Records prepared for chunk execution', {
+        requestId,
+        resource,
+        totalRecords,
+        chunkCount,
+        preparationTimeMs: riskInfo.elapsedMs,
+        remainingTimeMs: riskInfo.remainingMs,
+        timeoutRisk: riskInfo.risk,
+    });
+    // タイムアウトリスクが高い場合の警告
+    if (riskInfo.risk === 'high') {
+        logger.warn('High timeout risk detected during preparation phase', {
+            requestId,
+            resource,
+            preparationElapsedMs: riskInfo.elapsedMs,
+            remainingTimeMs: riskInfo.remainingMs,
+            lambdaTimeoutMs: LAMBDA_TIMEOUT_MS,
+            recommendation: 'Consider reducing batch size or optimizing preparation logic',
+        });
+    }
+}
+/**
+ * バルク操作完了時のログを出力する
+ *
+ * @param operation - 操作名（createMany、updateMany、deleteManyなど）
+ * @param requestId - リクエストID
+ * @param resource - リソース名
+ * @param requested - リクエストされたレコード数
+ * @param succeeded - 成功したレコード数
+ * @param failed - 失敗したレコード数
+ * @param riskInfo - タイムアウトリスク情報
+ * @param additionalInfo - 追加情報（オプション）
+ */
+export function logBulkOperationComplete(operation, requestId, resource, requested, succeeded, failed, riskInfo, additionalInfo) {
+    const totalElapsedSeconds = Math.round(riskInfo.elapsedMs / 1000);
+    logger.info(`${operation} completed`, {
+        requestId,
+        resource,
+        requested,
+        succeeded,
+        totalFailed: failed,
+        totalExecutionTimeMs: riskInfo.elapsedMs,
+        totalExecutionTimeSeconds: totalElapsedSeconds,
+        lambdaTimeoutMs: LAMBDA_TIMEOUT_MS,
+        timeoutUtilization: `${riskInfo.utilizationPercent}%`,
+        ...additionalInfo,
+    });
+}
+/**
+ * 部分失敗時の詳細ログを出力する
+ *
+ * @param operation - 操作名（createMany、updateMany、deleteManyなど）
+ * @param requestId - リクエストID
+ * @param resource - リソース名
+ * @param requested - リクエストされたレコード数
+ * @param succeeded - 成功したレコード数
+ * @param failed - 失敗したレコード数
+ * @param errorCodes - エラーコードの配列
+ * @param additionalInfo - 追加情報（オプション）
+ */
+export function logPartialFailure(operation, requestId, resource, requested, succeeded, failed, errorCodes, additionalInfo) {
+    const failureRate = Math.round((failed / requested) * 100);
+    logger.warn(`Partial failure in ${operation} operation`, {
+        requestId,
+        resource,
+        totalRequested: requested,
+        successCount: succeeded,
+        failedCount: failed,
+        failureRate: `${failureRate}%`,
+        errorCodes: [...new Set(errorCodes)],
+        ...additionalInfo,
+    });
+}
+//# sourceMappingURL=bulkOperations.js.map

package/dist/server/utils/bulkOperations.js.map

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

package/dist/server/utils/chunking.d.ts

@@ -0,0 +1,96 @@
+/**
+ * DynamoDB TransactWriteItemsの最大アイテム数制限
+ *
+ * DynamoDBのTransactWriteItemsは最大100アイテムまでしか処理できない。
+ * この制限を超える場合は、複数のトランザクションに分割する必要がある。
+ *
+ * 参考: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transaction-apis.html
+ */
+export declare const DYNAMODB_TRANSACT_WRITE_MAX_ITEMS = 100;
+/**
+ * チャンク分割結果
+ */
+export interface ChunkResult<T> {
+    /** チャンク配列（各チャンクは100アイテム以下） */
+    chunks: T[][];
+    /** 各チャンクのアイテム数 */
+    itemCounts: number[];
+}
+/**
+ * バルク操作のチャンクサイズを動的に計算する
+ *
+ * 各レコードのアイテム数（メインレコード + シャドーレコード）を考慮して、
+ * TransactWriteItemsの100アイテム制限内に収まるようにチャンクを分割する。
+ *
+ * @param records - 処理対象のレコード配列
+ * @param getItemCount - 各レコードのアイテム数を計算する関数
+ * @returns チャンク分割結果
+ * @throws {Error} 単一レコードが100アイテムを超える場合
+ *
+ * @example
+ * ```typescript
+ * // createMany操作の例
+ * const result = calculateChunks(records, (record) => {
+ *   const shadowCount = calculateShadowCount(record);
+ *   return 1 + shadowCount; // メイン + シャドー
+ * });
+ *
+ * // updateMany操作の例
+ * const result = calculateChunks(records, (record) => {
+ *   const oldShadowCount = record.__shadowKeys?.length || 0;
+ *   const newShadowCount = calculateNewShadowCount(record);
+ *   return 1 + oldShadowCount + newShadowCount; // メイン + 削除 + 追加
+ * });
+ * ```
+ */
+export declare function calculateChunks<T>(records: T[], getItemCount: (record: T) => number): ChunkResult<T>;
+/**
+ * チャンク実行結果
+ */
+export interface ChunkExecutionResult<T> {
+    /** 成功したレコード */
+    successRecords: T[];
+    /** 失敗したレコードのID */
+    failedIds: string[];
+    /** エラー情報 */
+    errors: ChunkError[];
+}
+/**
+ * チャンクエラー情報
+ */
+export interface ChunkError {
+    /** レコードID */
+    id: string;
+    /** エラーコード */
+    code: string;
+    /** エラーメッセージ */
+    message: string;
+}
+/**
+ * チャンクを順次実行し、結果を集約する
+ *
+ * 各チャンクを独立したトランザクションとして実行し、1つのチャンクが失敗しても
+ * 他のチャンクの処理を継続する（部分成功サポート）。
+ *
+ * @param chunks - 実行するチャンク配列
+ * @param executeChunk - 各チャンクを実行する関数（成功したレコードを返す）
+ * @param getRecordId - レコードからIDを取得する関数
+ * @returns チャンク実行結果
+ *
+ * @example
+ * ```typescript
+ * const result = await executeChunks(
+ *   chunks,
+ *   async (chunk) => {
+ *     // TransactWriteItemsでチャンクを実行
+ *     await dynamoDBClient.send(new TransactWriteItemsCommand({
+ *       TransactItems: buildTransactItems(chunk)
+ *     }));
+ *     return chunk; // 成功したレコードを返す
+ *   },
+ *   (record) => record.id
+ * );
+ * ```
+ */
+export declare function executeChunks<T>(chunks: T[][], executeChunk: (chunk: T[]) => Promise<T[]>, getRecordId: (record: T) => string): Promise<ChunkExecutionResult<T>>;
+//# sourceMappingURL=chunking.d.ts.map

package/dist/server/utils/chunking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.d.ts","sourceRoot":"","sources":["../../../src/server/utils/chunking.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;IACd,kBAAkB;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,EAAE,EACZ,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GAClC,WAAW,CAAC,CAAC,CAAC,CAsDhB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,eAAe;IACf,cAAc,EAAE,CAAC,EAAE,CAAC;IACpB,kBAAkB;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY;IACZ,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,MAAM,EAAE,CAAC,EAAE,EAAE,EACb,YAAY,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,EAC1C,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CA8FlC"}